跳到主要内容
版本：v8

配置 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">我的应用</string>

将 Activity 名称也进行相应的更改可能更有意义，特别是当您的应用只有一个 Activity 时：

<string name="title_activity_main">我的应用</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>

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

Contents

编辑此页