教程文档

从零开始,快速搭建您的UrShop商城

1

新建数据库

首先在 MySQL 中创建数据库。目前我们提供 MySQL 版本的初始化脚本 urshopdb.sql,导入该脚本即可完成数据库的初始化。

MySQL 命令
-- 创建数据库
CREATE DATABASE urshopdb CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;

-- 导入数据
mysql -u root -p urshopdb < urshopdb.sql
请确保 MySQL 版本为 5.7 或以上,推荐使用 utf8mb4 字符集以支持 Emoji 表情。
2

配置 dataSettings.json

打开 Urs.Shop\App_Data 文件夹,找到 dataSettings.json 文件,根据您的环境修改其中的配置。

dataSettings.json
{
  "database": {
    "type": "mysql",
    "host": "127.0.0.1",
    "port": 3306,
    "database": "urshopdb",
    "user": "root",
    "password": "your_password"
  }
}
文件路径位于项目根目录下的 Urs.Shop\App_Data\ 文件夹中。
3

修改连接字符串

在 dataSettings.json 中配置正确的数据库连接字符串,确保应用程序能够正常连接到您的 MySQL 数据库。

连接字符串配置
{
  "ConnectionStrings": {
    "DefaultConnection": "Server=127.0.0.1;Port=3306;Database=urshopdb;User=root;Password=your_password;CharSet=utf8mb4;"
  }
}
请将 your_password 替换为您实际的数据库密码,确保数据库服务已启动。
4

运行 UrShop.sln

使用 Visual Studio 2019 或以上版本打开项目根目录下的 UrShop.sln 解决方案文件,编译并运行项目。

运行命令
# 使用 Visual Studio 2019/2022
# 1. 双击打开 UrShop.sln
# 2. 还原 NuGet 包
# 3. 按 F5 运行项目

# 或使用 dotnet CLI
dotnet restore
dotnet run --project Urs.Shop
首次运行会自动创建管理员账户,请注意控制台输出的默认账号和密码信息。
5

配置小程序 host

使用微信开发者工具打开项目中的 miniprogram 文件夹,在 app.js 中修改 globalData.host 为您的后端服务地址。

app.js
// miniprogram/app.js
App({
  globalData: {
    host: 'https://your-domain.com',
    // ... 其他配置
  }
})
请将 host 地址替换为您实际的服务器域名或本地测试地址(如 http://localhost:5000)。
6

本地测试域名校验

在微信开发者工具中,点击右上角"详情" → "本地设置",勾选"不校验合法域名、web-view(业务域名)、TLS 版本以及 HTTPS 证书"。

设置步骤
操作路径:
微信开发者工具 → 详情 → 本地设置
☑ 不校验合法域名、web-view(业务域名)、
   TLS 版本以及 HTTPS 证书
此选项仅在本地开发调试时使用,正式上线前请务必配置合法的服务器域名。
7

上传小程序代码

定制开发完成后,在微信开发者工具中点击右上角的"上传"按钮,填写版本号和项目备注,将代码上传至微信后台。

上传流程
上传步骤:
1. 点击微信开发者工具右上角"上传"
2. 填写版本号(如 1.0.0)
3. 填写项目备注
4. 确认上传
上传前请确保代码已经过充分测试,并在本地预览中确认功能正常。
8

发布体验版与审核上线

登录微信公众平台,在"版本管理"中将上传的代码设置为体验版进行测试。测试通过后提交审核,审核通过后即可发布线上版本。

发布流程
发布流程:
1. 登录 mp.weixin.qq.com
2. 进入 管理 → 版本管理
3. 选择开发版本 → 选为体验版
4. 体验测试通过后 → 提交审核
5. 审核通过 → 发布上线
小程序审核通常需要 1-7 个工作日,请提前规划发布时间。审核期间不影响体验版的正常使用。