• 下载
  • 社区

打包上传

在小程序完成开发之后,项目代码需要打包上传至开放平台,然后才能提交审核与发布上线。

前提步骤

在上传代码之前,本地项目需要关联至后台小程序,用于确定上传位置。如果尚未关联,点击工具栏右侧的 上传 菜单时,会有弹窗提示进行关联。

上传方法

在工具栏右侧的 上传 菜单栏中,点击 上传 按钮。

上传成功之后,后台会生成新的开发版本条目。查看方法:登录 小程序开发中心,点击所需小程序,版本条目会在开发管理页面的 版本详情 区域显示。

上传选项

  • 本次上传版本:每次上传时版本默认递增 0.0.1(必须大于线上版本),从而确保后台每份代码版本唯一。
  • 创建预检测任务:免费调用一台真机进行测试(每天 5 次限额),详情参见 预检测

配置域名白名单

在上传之前阶段(模拟器预览/调试、真机预览/调试),小程序默认不会限制域名访问;但在上传之后阶段(体验版本、审核版本、灰度版本、线上版本),小程序只能访问白名单域名。若未成功配置白名单,可能会导致小程序页面白屏。

配置步骤:

  1. 登录 小程序开发中心,选择所需小程序。
  2. 在左侧导航栏点击 设置,进入设置页面。
  3. 点击 开发设置 标签 服务器域名白名单 区域点击 添加
  4. 填写所需域名,点击 确定

注意:添加的域名必须支持 HTTPS 协议,而且已经完成备案。

白名单.png

常见报错

报错:整包大小过大实际大小超过 2048kb 限制
解决方案:精简图片等本地资源文件,或者使用 分包加载 功能。

报错:npm文件路径长度过长(最大允许 100 个字符)
解决方案:在 npm 包管理工具中改用 yarn:tnpm i --by=yarn

yarn.png

报错:未知错误
Debug 途径:在工具栏右侧的 上传 菜单栏中,点击 查看上传日志。