Skip to content

uni-app APK/IPA 打包和上架

打包前准备

配置文件准备

manifest.json 配置

  • 应用名称
  • 应用图标
  • 应用版本号
  • 应用描述
  • 权限配置
  • 平台特定配置

示例配置

json
{
  "name": "我的应用",
  "appid": "__UNI__XXXXXX",
  "description": "这是一个 uni-app 应用",
  "versionName": "1.0.0",
  "versionCode": 1,
  "transformPx": true,
  "app-plus": {
    "usingComponents": true,
    "nvueStyleCompiler": "uni-app",
    "compilerVersion": 3,
    "splashscreen": {
      "alwaysShowBeforeRender": true,
      "waiting": true,
      "autoclose": true,
      "delay": 0
    },
    "permission": {
      "scope.userLocation": {
        "desc": "用于获取您的位置信息"
      }
    }
  },
  "mp-weixin": {
    "appid": "wxXXXXXXXXXXXX",
    "setting": {
      "urlCheck": false
    },
    "permission": {
      "scope.userLocation": {
        "desc": "用于获取您的位置信息"
      }
    }
  }
}

证书准备

Android 证书

  • 生成 keystore 文件
  • 配置 keystore 信息

iOS 证书

  • 申请开发者账号
  • 创建 App ID
  • 生成证书签名请求 (CSR)
  • 创建开发和发布证书
  • 创建描述文件 (Provisioning Profile)

Android 打包

本地打包

步骤

  1. 在 HBuilderX 中打开项目
  2. 点击「发行」->「原生 App-云打包」
  3. 选择 Android 平台
  4. 配置打包参数
  5. 点击「打包」按钮

打包参数

  • 应用名称
  • 应用版本号
  • 应用图标
  • 启动图
  • 证书信息
  • 权限配置
  • 其他配置

云打包

步骤

  1. 在 HBuilderX 中打开项目
  2. 点击「发行」->「原生 App-云打包」
  3. 选择 Android 平台
  4. 选择打包方式(云端打包)
  5. 配置打包参数
  6. 点击「打包」按钮
  7. 等待打包完成,下载 APK 文件

注意事项

  • 云打包需要消耗打包次数
  • 打包时间可能较长
  • 确保网络连接稳定

本地打包(Android Studio)

步骤

  1. 在 HBuilderX 中导出 Android 原生项目
  2. 使用 Android Studio 打开项目
  3. 配置签名信息
  4. 构建 APK 或 AAB 文件

配置签名信息

gradle
// app/build.gradle
android {
    signingConfigs {
        release {
            storeFile file('your-keystore.jks')
            storePassword 'your-store-password'
            keyAlias 'your-key-alias'
            keyPassword 'your-key-password'
        }
    }
    buildTypes {
        release {
            signingConfig signingConfigs.release
            minifyEnabled false
            proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'
        }
    }
}

iOS 打包

云打包

步骤

  1. 在 HBuilderX 中打开项目
  2. 点击「发行」->「原生 App-云打包」
  3. 选择 iOS 平台
  4. 配置打包参数
  5. 点击「打包」按钮
  6. 等待打包完成,下载 IPA 文件

打包参数

  • 应用名称
  • 应用版本号
  • 应用图标
  • 启动图
  • 证书信息(p12 文件和描述文件)
  • 权限配置
  • 其他配置

本地打包(Xcode)

步骤

  1. 在 HBuilderX 中导出 iOS 原生项目
  2. 使用 Xcode 打开项目
  3. 配置签名信息
  4. 构建 IPA 文件

配置签名信息

  1. 在 Xcode 中选择项目
  2. 点击「Signing & Capabilities」
  3. 选择 Team
  4. 配置 Bundle Identifier
  5. 选择 Provisioning Profile

应用上架

Android 上架(Google Play)

步骤

  1. 注册 Google Play 开发者账号
  2. 创建应用
  3. 填写应用信息
  4. 上传 APK 或 AAB 文件
  5. 设置应用价格和分发国家/地区
  6. 提交审核
  7. 等待审核通过

注意事项

  • 开发者账号需要支付一次性费用
  • 应用需要符合 Google Play 的政策
  • 审核时间可能较长

Android 上架(国内应用商店)

步骤

  1. 注册各应用商店开发者账号
  2. 创建应用
  3. 填写应用信息
  4. 上传 APK 文件
  5. 提交审核
  6. 等待审核通过

常见应用商店

  • 应用宝
  • 华为应用市场
  • 小米应用商店
  • OPPO 应用商店
  • vivo 应用商店
  • 魅族应用商店

iOS 上架(App Store)

步骤

  1. 注册 Apple Developer Program 账号
  2. 在 App Store Connect 中创建应用
  3. 填写应用信息
  4. 上传 IPA 文件
  5. 提交审核
  6. 等待审核通过

注意事项

  • 开发者账号需要每年支付费用
  • 应用需要符合 App Store 的审核指南
  • 审核时间可能较长

打包和上架常见问题

证书问题

问题描述:证书配置错误,导致打包失败。

解决方案

  • 检查证书是否有效
  • 检查证书密码是否正确
  • 检查描述文件是否匹配
  • 重新生成证书和描述文件

权限问题

问题描述:应用权限配置错误,导致上架被拒绝。

解决方案

  • 只申请必要的权限
  • 为每个权限添加合理的描述
  • 遵循各应用商店的权限政策

应用被拒

问题描述:应用上架审核被拒绝。

解决方案

  • 仔细阅读拒绝原因
  • 按照要求修改应用
  • 重新提交审核
  • 必要时联系应用商店支持

打包失败

问题描述:打包过程中出现错误,导致打包失败。

解决方案

  • 检查代码中是否有语法错误
  • 检查配置文件是否正确
  • 检查证书信息是否正确
  • 查看打包日志,定位错误原因

最佳实践

代码优化

  • 优化应用体积,减少打包大小
  • 优化代码,提高应用性能
  • 确保应用在不同设备上的兼容性
  • 测试应用的稳定性

资源优化

  • 优化图片资源,减少图片大小
  • 合理使用动画,避免过度动画
  • 优化字体资源,减少字体大小
  • 合理使用缓存,减少网络请求

安全优化

  • 保护用户数据安全
  • 避免敏感信息泄露
  • 防止应用被反编译
  • 遵循各应用商店的安全政策

上架准备

  • 准备应用截图和视频
  • 编写清晰的应用描述
  • 选择合适的应用分类
  • 准备应用关键词

后续维护

  • 定期更新应用,修复 bug
  • 关注应用商店的政策变化
  • 收集用户反馈,持续优化应用
  • 保持应用的活跃度

总结

uni-app 打包和上架是应用开发的重要环节,需要仔细准备和执行。通过了解打包和上架的流程,掌握常见问题的解决方案,可以提高应用的质量和成功率。在打包和上架过程中,建议遵循各平台的规范和政策,确保应用能够顺利通过审核,为用户提供优质的体验。

基于 VitePress 的本地知识库