Skip to content

12. 部署

开发期间,[Android Studio] (或 [gradlew installDebug])安装应用的“debug”版本:它使用自动生成的调试密钥签名,并启用调试器。要部署应用,需要构建“release”版本。

12.1. 应用的生产版本

  1. 构建应用,并指定生产服务器的地址。在打开到 [rdvmedecins_kotlin] 文件夹的命令提示符窗口中:
gradlew assembleRelease -Pserver=https://rdvmedecins.example.com

[Gradle] 把 [Kotlin] 代码编译成“字节码”,再编译成 [Dalvik] 代码([.dex] 文件的格式,由 [Android] 的虚拟机 [ART] 执行),并把一切(连同资源和库)打包成一个 APK 文件:[Android] 应用的安装格式。与 [Flutter] 不同,这里没有需要内嵌的引擎:界面由 [Compose] 渲染,它只是一个普通的库。生成的文件 [app/build/outputs/apk/release/app-release-unsigned.apk] 只有几兆字节大小。

[app/build.gradle.kts] 中的 [buildTypes { release [ ... ] }] 块配置这个版本。在那里,你可以启用 [R8] 优化器([optimization [ enable = true ]]):它会移除库中未使用的代码并缩短名称,从而减小 APK 的体积。然后你必须指示它保留序列化器通过反射找到的内容([kotlinx.serialization] 的规则随该库一起提供),并测试优化后的版本。

  1. 签名。[Android] 只安装已签名的应用。最简单的方法是使用 [Android Studio]:菜单 [Build / Generate Signed App Bundle or APK] 会创建开发者密钥(一个受密码保护的“密钥库”文件,你必须妥善保管:应用的所有更新都必须用它签名),然后构建并签名 APK。你也可以在 [app/build.gradle.kts] 中定义签名(块 [signingConfigs]),通过从 [Gradle] 的属性中读取密码,而不是把它们硬编码。

  2. 安装。手机连接到电脑(USB 线,已启用 USB 调试)后:

adb install app-release.apk

你也可以把 APK 文件复制到手机上并打开它:[Android] 随后会要求你允许安装“来自未知来源”的应用。

  1. 正式发布:

  2. [Google Play Store] 要求提供“Android App Bundle”而不是 APK:[gradlew bundleRelease],或使用与 [Android Studio] 相同的菜单。Google 会生成适合每部手机的 APK 文件;

  3. 应用的名称和图标在 [res/values/strings.xml]([app_name])和 [res/mipmap-*/]([Android Studio] 的 [New / Image Asset] 菜单)中配置;
  4. [versionCode](一个整数)必须在每次发布时递增;[versionName] 是显示给用户的版本;
  5. 服务器必须配置为 HTTPS(因为要传输密码),并且要从清单中删除 [android:usesCleartextTraffic="true"] 这一行;
  6. 令牌存储在 [SharedPreferences] 中,这是应用的私有文件。为了增强安全性,可以使用 [Android] 的“密钥库”对其加密(库 [androidx.security])。

12.2. 生产服务器

在真实的生产环境中,不要忘记服务器上的 [.env] 文件:

  • 一个长的随机 [JWT_SECRET];
  • 一个空的 [CAPTCHA_TEST];
  • 如果站点通过 HTTPS 提供服务(必须如此),则设置 [COOKIE_SECURE=true]。无论是否设置该选项,移动客户端都会发送 Cookie:真正强制执行它的是浏览器;
  • 如果服务器位于代理([nginx] 等)之后,则设置 [TRUST_PROXY=true],这样尝试次数限制才能看到客户端的真实 IP 地址。

然后启动编译好的服务器:[npm run build],接着是 [npm run start:prod]。