uni-app微信小程序完整发布配置指南

Viewed 0

1. 下载并登录开发工具

首先,需要下载并安装微信开发者工具,推荐使用稳定版。安装完成后,打开工具并使用微信扫码登录。

2. 下载并安装HBuilderX

前往HBuilderX官网下载APP开发版,推荐使用4.29版本。下载完成后,进行安装。

3. 打开项目源码

打开HBuilderX编译器,点击菜单栏的“文件”->“打开目录”。在本地找到已下载的源码包,打开其中的 template/uni-app/ 目录。

4. 配置请求域名

在项目文件中找到 config/app.js 文件,将其中的请求域名修改为你自己的后台服务器地址。请注意,域名必须是以 https:// 开头的完整地址。

5. 发行小程序

配置保存后,点击HBuilderX上方的“发行”按钮(注意务必选择“发行”而非“运行”),然后选择“小程序-微信(仅适用于uni-app)”。

6. 填写发布信息并处理常见编译错误

在弹出的发布窗口中,正确填写你的小程序AppID和小程序名称,然后点击发布。下方选项可保持默认。

常见问题处理:

  • SCSS编译错误:如果打包时出现“预编译器错误:代码使用了scss/sass语言,但未安装相应编译器…”,需在HBuilderX中通过“工具”—“插件安装”菜单,安装scss/sass编译插件。
  • AppID错误:如果编译提示AppID相关的错误,需在项目的 manifest.json 文件中,点击“重新获取”以生成新的AppID。
  • 端口拒绝访问:打包完成后,若提示“微信开发者工具拒绝HBuilderX访问”,请根据提示在微信开发者工具中开启服务端口。
  • 插件未授权错误:如果在微信开发者工具中打开项目后,提示“插件未授权使用”(例如小程序直播插件),这是因为你的小程序尚未开通对应功能。需要按照提供的教程链接,在代码中删除未授权的插件引用。

7. 功能测试与问题排查

项目在微信开发者工具中打开后,应进行功能测试,例如点击“购物车”检查是否能正常授权登录。如果出现报错,请按以下顺序排查:

  1. 检查服务器SSL证书是否正确安装(在浏览器中输入https域名看能否正常访问)。
  2. 检查后台管理系统中的小程序AppID等配置信息是否正确。
  3. 检查微信公众平台中小程序的“服务器域名”和“业务域名”是否已正确配置。

8. 上传代码与审核准备

测试无误后,在微信开发者工具中点击“上传”按钮,填写版本号和备注,等待上传成功。

审核前重要配置:
为了确保小程序能通过审核,必须在微信公众平台配置“小程序订单中心path”以及“小程序的隐私政策”。

  • 订单中心path 应设置为:pages/goods/order_list/index
  • 在公众平台找到“订单中心path”和“用户隐私保护指引”的设置项,点击“更新”或“设置”以完成配置。

至此,uni-app微信小程序前端的配置与发布流程已完成。上传后,可在微信公众平台提交审核。如果过程中遇到其他非阻塞性提示(如某些样式警告),通常可以忽略并继续操作。

0 Answers