React Native构建Android APK：无需连接PC运行应用的方法

一、构建调试版APK（用于测试） #

调试版APK可快速生成，适合内部测试使用：

• 打开终端，进入React Native项目的android目录：

  cd android
  

• 执行gradle构建命令：
  • Mac/Linux：./gradlew assembleDebug
  • Windows：gradlew.bat assembleDebug
• 构建完成后，APK文件路径：android/app/build/outputs/apk/debug/app-debug.apk
• 将该APK文件通过微信、QQ或文件管理器传到手机，开启手机「允许安装未知来源应用」权限后即可安装运行。

二、构建发布版APK（用于正式分发） #

发布版APK经过性能优化，必须签名才能正常分发或上架应用商店：

1. 生成签名密钥 #

使用Java的keytool工具生成签名文件（确保已配置Java环境）：

keytool -genkey -v -keystore my-release-key.keystore -alias my-key-alias -keyalg RSA -keysize 2048 -validity 10000

• 按照提示设置密钥库密码、密钥密码、个人信息等内容
• 将生成的my-release-key.keystore文件移动到项目的android/app目录下

2. 配置签名信息 #

• 打开android/gradle.properties文件，添加以下配置（替换为你自己的密码和文件名）：

  MYAPP_UPLOAD_STORE_FILE=my-release-key.keystore
  MYAPP_UPLOAD_KEY_ALIAS=my-key-alias
  MYAPP_UPLOAD_STORE_PASSWORD=你的密钥库密码
  MYAPP_UPLOAD_KEY_PASSWORD=你的密钥密码
  

• 打开android/app/build.gradle文件，在android代码块内添加签名配置：

  signingConfigs {
      release {
          if (project.hasProperty('MYAPP_UPLOAD_STORE_FILE')) {
              storeFile file(MYAPP_UPLOAD_STORE_FILE)
              storePassword MYAPP_UPLOAD_STORE_PASSWORD
              keyAlias MYAPP_UPLOAD_KEY_ALIAS
              keyPassword MYAPP_UPLOAD_KEY_PASSWORD
          }
      }
  }
  

• 找到buildTypes下的release块，添加签名引用：

  buildTypes {
      release {
          minifyEnabled true
          proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'
          signingConfig signingConfigs.release // 添加这一行
      }
  }
  

3. 构建发布版APK #

• 回到终端，进入android目录，执行构建命令：
  • Mac/Linux：./gradlew assembleRelease
  • Windows：gradlew.bat assembleRelease
• 生成的发布版APK路径：android/app/build/outputs/apk/release/app-release.apk

注意事项 #

• 调试版APK带有调试标记，性能不如发布版，不适合对外分发
• 发布版APK的签名密钥不可更改，需妥善保存签名文件和密码
• 部分安卓机型需要在设置中开启「允许安装未知来源应用」才能安装非应用商店渠道的APK

内容的提问来源于stack exchange，提问作者Hamza Ch