XML<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
          package="com.netease.nim.demo">

    <!-- 权限声明 -->
    <!-- 网络相关权限 -->
    <uses-permission android:name="android.permission.INTERNET" />
    <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
    <uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />

    <application
        ...>
        <!-- AppKey 配置，可在此设置，也可在 SDKOptions 中提供
             若两处都提供，优先使用 SDKOptions 中的值 -->
        <meta-data
            android:name="com.netease.nim.appKey"
            android:value="key_of_your_app" />
        <!-- 云信后台服务声明 -->
        <service android:name="com.netease.nimlib.service.NimServiceV2" />
        
        <provider
                android:name="com.netease.nimlib.ipc.NIMContentProviderV2"
                android:authorities="${applicationId}.ipc.provider.v2"
                android:exported="false" />
    </application>
</manifest>

XML<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
          package="com.netease.nim.demo">

    <!-- 权限声明 -->
    <!-- 网络相关权限 -->
    <uses-permission android:name="android.permission.INTERNET" />
    <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
    <uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />


    <application
        ...>
        <!-- AppKey 配置，可在此设置，也可在 SDKOptions 中提供
             若两处都提供，优先使用 SDKOptions 中的值 -->
        <meta-data
            android:name="com.netease.nim.appKey"
            android:value="key_of_your_app" />
        <!-- 云信后台服务声明 -->
        <service
                android:name="com.netease.nimlib.service.NimService"
                android:process=":core"
                />
        
        <service
                android:name="com.netease.nimlib.push.net.HeartbeatService"
                android:process=":core"
                />
        
        <!-- 云信后台辅助服务 -->
        <service
                android:name="com.netease.nimlib.job.NIMJobService"
                android:exported="false"
                android:permission="android.permission.BIND_JOB_SERVICE"
                android:process=":core"
                />
        
        <!-- 云信监听系统启动和网络变化的广播接收器，用于开机自启和网络变化时重新登录 -->
        <receiver
                android:name="com.netease.nimlib.service.NimReceiver"
                android:exported="false"
                android:process=":core"
                >
            <intent-filter>
                <action android:name="android.net.conn.CONNECTIVITY_CHANGE" />
            </intent-filter>
        </receiver>
        
        <!-- 云信进程间通信组件 -->
        <receiver android:name="com.netease.nimlib.service.ResponseReceiver"
                />
        
        <service android:name="com.netease.nimlib.service.ResponseService"
                />
        
        <!-- 云信进程间通信 provider -->
        <provider
                android:name="com.netease.nimlib.ipc.cp.provider.PreferenceContentProvider"
                android:authorities="${applicationId}.ipc.provider.preference"
                android:exported="false"
                />
        <provider
                android:name="com.netease.nimlib.ipc.NIMContentProvider"
                android:authorities="${applicationId}.ipc.provider"
                android:exported="false"
                android:process=":core"
                />
    </application>
</manifest>

为避免混淆导致调用 NIM SDK 时出现异常，请在 proguard-rules.pro 文件中添加以下规则，将 NIM SDK 相关类排除在混淆范围外：

ProGuard-dontwarn com.netease.nim.**
-keep class com.netease.nim.** {*;}

-dontwarn com.netease.nimlib.**
-keep class com.netease.nimlib.** {*;}

-dontwarn com.netease.share.**
-keep class com.netease.share.** {*;}

-dontwarn com.netease.mobsec.**
-keep class com.netease.mobsec.** {*;}

#全文检索插件需要添加
-dontwarn org.apache.lucene.**
-keep class org.apache.lucene.** {*;}

#数据库功能需要添加
-keep class net.sqlcipher.** {*;}
-keep class net.zetetic.** {*;}

面向海外发行且使用 R8 打包的应用，需遵循 Google Play 对 DEX 代码 优化的明确要求。

1. 由于 -keep class com.netease.nimlib.** 等整包 keep 规则保留范围过大，会导致 R8 无法有效收缩代码，反而不利于满足该要求。因此，先查看 proguard-rules.pro 文件，删除以下旧规则：

   -keep class com.netease.nimlib.** { *; }
   -keep class com.netease.** { *; }
   -keep class org.apache.lucene.** {*;}
   -keep class net.sqlcipher.** {*;}
   -keep class net.zetetic.** {*;}
   

2. 自 10.11.0-r8 或 10.11.5 版本起，使用云信 SDK 时请通过 proguardFiles 引入经收窄、统一整理的宿主混淆规则文件 nim-sdk-r8-rules.pro，以替换原有的整包 keep 规则。

gradleproguardFiles getDefaultProguardFile('proguard-android-optimize.txt'),
                      'proguard-rules.pro',
                      'nim-sdk-r8-rules.pro'

V2 模式是 10.x.x+ 版本系列 NIM SDK 推荐的全新初始化方式，提供了更多功能和性能优化。使用 V2 模式需注意：

1. 初始化时调用 NIMClient#initV2 方法。
2. AndroidManifest.xml 中仅需声明 V2 相关服务（NimServiceV2 和 NIMContentProviderV2）。
3. 初始化和参数配置需按照 V2 方式进行。详情请参考 初始化 Android SDK。

如果需要保持与 10.0.0 以下版本 NIM SDK 的兼容性，可选择 V1 兼容模式：

1. 初始化时调用 NIMClient#init 方法。
2. AndroidManifest.xml 中需声明所有 V1 相关服务（NimService、HeartbeatService 等）。
3. 初始化和参数配置需按照 V1 方式进行，详情请参考 初始化。