📦 App打包配置指南

现在你的App已经可以在模拟器和真机上运行了。接下来需要配置打包参数，为发布到应用市场做准备。

这一步涉及很多细节配置，包括APP图标、权限、支付、分享等。配置得当，才能正常打包！

---

🎯 理解App打包配置

App打包配置就是告诉HBuilderX如何构建你的应用：

配置内容包括：

• 🎨 应用图标和启动屏配置
• 🔑 应用标识和版本信息
• 📍 地理定位服务配置
• 💳 支付方式配置
• 📲 消息推送配置
• 🔗 社交分享配置
• 🎥 视频播放配置
• 🔐 应用权限配置
• 🌐 网络配置

---

🎯 第一步：修改API接口地址

确保API地址正确

打包时需要确认API地址是生产环境地址：

1. 打开项目：找到 src/config/app.js 或 src/api/config.js
2. 检查接口地址

// src/config/api.js
export const API_URL = 'https://yoursite.com'  // 改成你的正式域名

⚠️ 重点：

• 必须是 HTTPS（不能是 HTTP）
• 必须是有效的域名或IP地址
• 确保后端服务器已部署并正常运行

---

🎯 第二步：配置应用基本信息

打开manifest.json配置界面

1. 在HBuilderX中打开 manifest.json
2. 点击"基础配置"标签

你会看到一个配置表单，需要填写以下信息：

配置应用标识和信息

配置项	说明	示例
应用标识（AppID）	UniApp生成的唯一ID	自动生成，勿改
应用名称	用户看到的应用名字	"我的商城"
应用描述	应用在商城显示的描述	"全新的购物体验"
应用版本名称	版本号显示格式	"1.0.0"
应用版本号	用于版本升级检测	"100"

💡 小贴士： 版本号必须是纯数字，每次打包时要递增

---

🎯 第三步：配置应用图标

上传应用图标

1. 在manifest.json中点击"App图标配置"标签
2. 上传应用图标

图标要求：

类型	尺寸	格式	说明
应用图标	1024×1024	PNG	方形，支持透明背景
应用启动屏	1080×1920	PNG	竖屏，全屏显示

自动生成所有规格

1. 点击"自动生成所有图标并替换"
2. HBuilderX会自动生成各种分辨率的图标
3. 等待生成完成

✅ 完成后： 所有不同分辨率的图标都准备好了

---

🎯 第四步：配置App模块

打开模块配置

点击 manifest.json 中的"App模块配置"标签，这里可以配置各种功能模块。

4️⃣.1 地理定位配置

选择地理定位模块：

1. 勾选 "Geolocation"

2. 选择定位服务

   • 高德定位（推荐）
   • 百度定位

3. 填写App Key

   • appkey_ios - iOS的App Key
   • appkey_android - Android的App Key

💡 获取App Key：

• 高德地图：https://lbs.amap.com/ → 创建应用 → 获取Key
• 百度地图：https://lbsyun.baidu.com/ → 创建应用 → 获取Key

⚠️ 重要： iOS和Android都要填写对应的Key，否则定位功能无法使用

4️⃣.2 直播模块配置

勾选 "LivePusher"： 如果你的应用需要直播功能

4️⃣.3 地图模块配置

选择地图服务：

1. 勾选 "Maps"

2. 选择地图提供商

   • 高德地图（推荐）
   • 百度地图

3. 填写地图App Key

   • appkey_ios
   • appkey_android

4️⃣.4 社交登录配置（推荐）

微信登录：

1. 勾选 "OAuth(登录授权)"
2. 选择 "微信登录"
3. 填写微信开放平台信息
   • appid - 微信App ID
   • appsecret - 微信App Secret（不上传到客户端，仅后端使用）
   • Universal Links - iOS通用链接

⚠️ iOS特别说明：

• 必须同时勾选 "Apple ID登录"
• 需要配置苹果开发者账号

📝 获取微信登录凭证：

1. 进入微信开放平台
2. 管理中心 → 应用管理
3. 选择你的移动应用
4. 在 "应用信息" 中找到 AppID 和 AppSecret

4️⃣.5 支付配置

选择支付方式：

1. 勾选 "Payment(支付)"
2. 选择支付服务商
   • 微信支付
   • 支付宝支付

微信支付配置：

• appid - 微信开放平台的App ID
• Universal Links - iOS通用链接

支付宝配置：

• appid - 支付宝的App ID
• 其他凭证在后端配置

4️⃣.6 消息推送配置

勾选 "Push(消息推送)"： 如果需要推送通知功能

推送服务通常由后端处理，前端只需勾选即可。

4️⃣.7 社交分享配置

勾选 "Share(分享)"：

1. 选择分享渠道

   • 微信分享（推荐）
   • QQ分享
   • 微博分享

2. 填写微信分享配置

   • appid - 微信开放平台的App ID
   • Universal Links - iOS通用链接

4️⃣.8 视频播放配置

勾选 "VideoPlayer(视频播放)"： 如果应用中有视频功能

---

🎯 第五步：配置应用权限

打开权限配置

点击 manifest.json 中的"App权限配置"标签。

Android权限（自动配置）

HBuilderX会根据你使用的功能，自动添加所需的Android权限：

权限	用途	说明
INTERNET	网络访问	必需
ACCESS_FINE_LOCATION	精准定位	如果使用定位
CAMERA	摄像头	如果使用相机
WRITE_EXTERNAL_STORAGE	写入存储	如果保存文件
READ_CONTACTS	读取通讯录	如果需要
RECORD_AUDIO	录音	如果使用麦克风

✅ 一般不需要手动修改，HBuilderX会自动处理

iOS权限（需要配置）

iOS对权限的要求更严格。需要在 Info.plist 中添加权限说明：

权限	说明	示例
NSLocationWhenInUseUsageDescription	定位说明	"需要获取你的位置用于配送"
NSCameraUsageDescription	相机说明	"需要使用相机拍照"
NSMicrophoneUsageDescription	麦克风说明	"需要录音进行视频通话"
NSContactsUsageDescription	通讯录说明	"需要访问你的联系人"

⚠️ iOS 14+隐私要求： 必须提供清晰的权限说明文字

---

🎯 第六步：配置其他选项

打开常用其他配置

点击 manifest.json 中的"App常用其他配置"标签。

这里有一些兼容性和性能选项，建议根据情况勾选：

选项	说明	建议
Webview调试	开启后可远程调试	开发时勾选，发布时取消
完整屏幕适配	适配各种屏幕尺寸	✅ 勾选
沉浸式状态栏	全屏显示	✅ 勾选
软输入框处理	输入法自动调整	✅ 勾选
分辨率自适应	自动适配分辨率	✅ 勾选

💡 小贴士： 初次打包时，建议把所有兼容性选项都勾选上，确保应用在各种设备上都能正常运行。

---

🎯 第七步：版本更新配置

配置更新检测

在 manifest.json 中找到"更新检测"配置：

{
  "app-plus": {
    "uniMixins": {
      "updateCheckSettings": {
        "checkUpdate": true,
        "checkUpdateUrl": "https://yoursite.com/api/appupdate"
      }
    }
  }
}

说明：

• checkUpdate - 是否检查更新（true 为启用）
• checkUpdateUrl - 后端API地址，返回最新版本信息

后端需要返回的数据结构：

{
  "version": "1.0.1",
  "versionCode": 101,
  "downloadUrl": "https://yoursite.com/app/myapp-1.0.1.apk",
  "updateDescription": "修复了一些bug，优化了性能",
  "forceUpdate": false
}

💡 小贴士： 强制更新时设置 forceUpdate: true，用户必须更新才能继续使用

---

⚠️ 常见配置问题

Q: 为什么需要配置这么多参数？

A: 这些参数决定了：

• 应用在各应用市场的展示信息
• 应用的功能和权限
• 用户在使用时的体验
• 应用能否顺利上架审核

配置越完整，应用越稳定。

Q: 微信登录和支付配置一定要在这里填吗？

A: 不一定：

• 前端：填AppID和Universal Links
• 后端：填AppSecret和支付密钥
• 前后端配合才能正常工作

⚠️ 安全提示： 永远不要在前端代码或配置中暴露 AppSecret 或支付密钥！

Q: iOS和Android权限配置不一样吗？

A: 差别很大：

• Android：权限在打包时自动配置
• iOS：需要在 Info.plist 手动配置权限说明

iOS的权限说明是强制要求，缺少会导致审核被拒。

Q: 什么时候应该使用高德地图vs百度地图？

A: 两者都可以，但：

• 高德：覆盖更全，更新更快
• 百度：国内用户较多，接入文档详细

建议选择高德。

Q: 版本号应该怎么设置？

A: 两个版本号的意义：

• 应用版本名称（1.0.0）：用户看到的版本号
• 应用版本号（100）：系统用来判断更新

规律：

• 版本名称：大版本.小版本.补丁版本
• 版本号：纯数字，每次打包递增

比如：

• 1.0.0 → 版本号 100
• 1.0.1 → 版本号 101
• 1.1.0 → 版本号 110
• 2.0.0 → 版本号 200

---

📋 App打包配置检查清单

配置完成后，检查这些项目：

• [ ] API接口地址已修改为生产环境
• [ ] AppID已生成，未修改
• [ ] 应用名称、描述、版本信息已填写
• [ ] 应用图标已上传，自动生成完成
• [ ] 地理定位配置已完成（如需要）
• [ ] 社交登录AppID已填写
• [ ] 支付方式已配置
• [ ] 消息推送已勾选
• [ ] 社交分享已配置
• [ ] 应用权限已检查
• [ ] iOS权限说明已配置
• [ ] 版本号已设置（纯数字，与版本名称对应）

---

🎉 配置完成！

现在你的应用已经准备好打包了！

下一步：

1. App打包上线 - 开始打包并发布到应用市场

✨ 温馨提示： 配置好这些参数后，应用不仅能更好地在各个平台上运行，而且更容易通过应用市场的审核。每一项配置都很重要，不要跳过！

祝你的App打包配置顺利！🚀