配置 Android

配置 AndroidManifest.xml

Android 应用在 AndroidManifest.xml 文件中管理权限、设备功能和其他设置，该文件位于 android/app/src/main/AndroidManifest.xml。

AndroidManifest.xml 可能会通过 @style 和 @string 引用 android/app/src/main/res/values 目录内的其他文件，例如 styles.xml 和 strings.xml。详细了解 Android 资源。

本文涵盖您需要对应用进行的基本修改。阅读 Android Manifest 文档 以了解更多内容。

更改包 ID

要更改应用的包 ID（在 Android 中又称应用 ID），请编辑 android/app/build.gradle 顶部的 applicationId：

defaultConfig {
-       applicationId "com.capacitorjs.app"
+       applicationId "com.mycompany.myapp"

更改应用名称

要更改应用的名称，请修改 strings.xml 中 app_name 的值：

<string name="app_name">MyApp</string>

相应地更改活动名称可能也有意义，特别是当您的应用只有一个活动时：

<string name="title_activity_main">MyApp</string>

深度链接（即 Android 应用链接）

关于深度链接的完整指南，请参阅此处。

要启用通过 Android 应用链接的深度链接，请遵循官方的 Android 指南 添加 Android 应用链接。Android Studio 自带一个便捷的向导来配置应用链接。

配置完成后，App API 中的 getLaunchUrl() 方法 将提供应用启动时使用的任何 URL，并且每当应用收到新的应用链接深度链接时，'appUrlOpen' 事件 就会触发。

URL 方案

您的应用可以响应启动时的自定义 URL，从而能够处理深度链接和应用交互。

要更改 URL，请在 strings.xml 中搜索并修改以下行。建议将其设置为包 ID。

<string name="custom_url_scheme">com.capacitorjs.myapp</string>

在此示例中，应用将响应使用 com.capacitorjs.myapp:// 方案的 URL。

要获取应用可能启动时使用的任何自定义 URL，请参阅上面的深度链接部分。

设置权限

在 Android 中，应用需要的权限在 AndroidManifest.xml 文件内的 <manifest> 标签中定义，通常位于文件底部。

例如，添加网络权限的示例如下：

<manifest xmlns:android="http://schemas.android.com/apk/res/android"
package="com.getcapacitor.myapp">
    <activity>
      <!-- 其他内容 -->
    </activity>

    <!-- 更多内容 -->

    <!-- 您的权限 -->

    <!-- 网络 API -->
    <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
</manifest>

通常，您选择使用的插件会要求您设置权限。请在此文件中添加。