# rpg-封装接入指南

---

本文档是对 RPG MV Maker 引擎游戏的Android Studio模板工程的说明， [下载模板工程](https://sdkftp.4399doc.com/external/operate/3.20.0/operate-rpg-3.20.0+726.zip)

由于此工程已接入 4399 SDK，游戏只需要确认版本和打包配置即可

## 集成流程

### 引入SDK
- **确认 SDK 版本**：在 `app/build.gradle`中
```
dependencies {
    // 运营 SDK，建议使用最新版本，可通过浏览仓库地址或向运营咨询版本
    implementation "cn.m4399.sdk:operate:3.20.0"
}
```

- **替换 Game Key**：将`app/src/main/java/cn/m4399/rpgsample/RPGMakerActivity`中的`GAME_KEY`替换为实际值

### 调整游戏打包配置
- **修改应用`applicationId`** ：注意不同的游戏包要确定好包名
- **确认并修改版本`versionCode, versionName`**
```
android {
    defaultConfig {
        applicationId "cn.m4399.rpgsample"
        versionCode 20201001
        versionName "2.1.0b"
    }
}
```

#### AndroidManifest.xml
- **修改游戏包名`package`** ：此设置与`applicationId`可以一致
- **修改游戏图标`android:icon`和`android:roundIcon`**
- **修改游戏名`android:label`**

```
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:tools="http://schemas.android.com/tools"
    package="com.example.rpgsample">
...
    <application
        android:icon="@mipmap/ic_launcher"
        android:label="@string/app_name"
        android:roundIcon="@mipmap/ic_launcher_round"
        android:theme="@style/AppTheme"
        tools:ignore="UnusedAttribute">
...
</manifest>
```

#### 签名
游戏应使用`apktool`或 as 生成签名文件，或使用已有签名文件  
并参考`app/build.gradle`中`signingConfigs`定义与使用方式配置打包签名

### 替换游戏包
最后，**删除`app/src/main/assets`下原有所有文件，并将编译好的RPG Maker游戏文件移动到其下**

完成最后的步骤后，同步项目，即可打包验证