Android SDK_安装SDK和配置环

安装GAMEPOT Android SDK后配置环境并关联GAMEPOT Dashboard和游戏，即可使用游戏开发所需的功能。

安装SDK

安装GAMEPOT Android SDK后，在Android Studio配置项目的方法如下。

  1. 请使用管理员账户登录Dashboard。

  2. 依次点击 SDK下载 > Android 菜单后，请点击 下载。

  3. 运行Android Studio后，请打开游戏项目。

  4. 解压已下载的AOS SDK文件后，请将libs文件夹内的所有文件复制到游戏项目的libs文件夹下。

修改build.gradle

修改 build.gradle文件的方法如下。

  1. 请使用下列代码修改项目root文件夹内的build.gradle文件。

    buildscript {

    repositories {
        ...
        google()
        mavenCentral()
        maven { url "https://jitpack.io" }
    }
    dependencies {
       ...
        classpath 'com.google.gms:google-services:4.3.14'
    }
}

allprojects {
    repositories {
        ...
        google()
        mavenCentral()
        maven { url "https://jitpack.io" }
    }
}

  2. 参考表格修改下列代码的值后，请使用代码修改app文件夹内的build.gradle文件。gamepot_payment值默认为空。

    值

    说明

    gamepot_project_id

    由GAMEPOT发放的项目ID （在Dashboard 项目设置 > 一般 菜单中进行确认）

    gamepot_store

    输入Store值 google、one或galaxy

    gamepot_app_title

    APP标题（FCM）

    gamepot_push_default_channel

    禁止更改（已注册的默认渠道名称）

    facebook_app_id

    由Facebook发放的APP ID

    fb_login_protocol_scheme

    fb[由Facebook发放的APP ID] ex) fb101010

    facebook_client_token

    Facebook控制台 > APP > 设置 > 高级设置 > 客户端Token

    gamepot_elsa_projectid

    使用NAVER Cloud ELSA服务时，输入ELSA项目ID （参阅Effective Log Search & Analytics)

    gamepot_region

    仅在GAMEPOT Dashboard创建地区为新加坡时输入sg

    gamepot_license_url

    仅在GAMEPOT Dashboard创建地区为日本时输入 https://gamepot.apigw.ntruss.com/fw/jp-v1

    android {
    defaultConfig {
        ...
        // GamePot [START]
        resValue "string", "gamepot_project_id", "[projectId]" // required
        resValue "string", "gamepot_store", "[storeId]" // required
        resValue "string", "gamepot_payment", "[storeId]" // optional
        resValue "string", "gamepot_app_title","@string/app_name" // required (fcm)
        resValue "string", "gamepot_push_default_channel","Default" // required (fcm)
        resValue "string", "facebook_app_id", "[Facebook ID]" // facebook
        resValue "string", "fb_login_protocol_scheme", "fb[Facebook ID]" // (facebook)
        resValue "string", "facebook_client_token", "[Facebook客户端Token]" // Facebook控制台 > APP > 高级设置 > 客户端Token
        // resValue "string", "gamepot_elsa_projectid", "" // (ncp elsa)
        resValue "string", "gamepot_region", "" // Caution! Only if the gamepot region is Singapore , value as sg
        resValue "string", "gamepot_license_url", "" // Caution! Only if the gamepot region is Japan , value as https://gamepot.apigw.ntruss.com/fw/jp-v1
        // GamePot [END]
    }

    packagingOptions {
        exclude 'META-INF/proguard/androidx-annotations.pro'
    }
}

repositories {
    flatDir {
        dirs 'libs'
    }
}

dependencies {
 implementation 'androidx.appcompat:appcompat:1.2.0'
 implementation 'androidx.multidex:multidex:2.0.1'

 // GamePot common [START]
 implementation(name: 'gamepot-common', ext: 'aar')
 implementation('io.socket:socket.io-client:1.0.0') {
     exclude group: 'org.json', module: 'json'
 }
 implementation('com.github.ihsanbal:LoggingInterceptor:3.0.0') {
     exclude group: 'org.json', module: 'json'
 }
 implementation "com.github.nisrulz:easydeviceinfo:2.4.1"
 implementation 'com.android.installreferrer:installreferrer:1.0'
 implementation 'com.google.code.gson:gson:2.8.2'
 implementation 'com.jakewharton.timber:timber:4.7.0'
 implementation 'com.squareup.okhttp3:okhttp:4.9.1'
 implementation 'com.apollographql.apollo:apollo-runtime:2.5.14'
 implementation 'com.apollographql.apollo:apollo-android-support:2.5.14'
 implementation 'com.android.billingclient:billing:7.0.0'
 implementation 'com.google.firebase:firebase-crashlytics-buildtools:2.9.1'
 implementation 'com.github.bumptech.glide:glide:3.7.0'
 implementation 'androidx.sqlite:sqlite-framework:2.0.1'
 implementation 'com.google.firebase:firebase-core:18.0.1'
 implementation 'com.google.firebase:firebase-messaging:23.1.2'
 implementation 'com.google.firebase:firebase-iid:21.1.0'
 implementation "androidx.swiperefreshlayout:swiperefreshlayout:1.1.0"
 implementation 'pub.devrel:easypermissions:3.0.0'
 implementation(name: 'pageindicatorview-1.0.3', ext: 'aar')
 implementation(name: 'puree-4.1.6', ext: 'aar')
 implementation 'androidx.swiperefreshlayout:swiperefreshlayout:1.1.0'
 // GamePot common [END]

 implementation(name: 'gamepot-channel-base', ext: 'aar')
 
 // GamePot facebook [START]
 implementation(name: 'gamepot-channel-facebook', ext: 'aar')
 implementation 'com.facebook.android:facebook-android-sdk:14.1.1'
 // GamePot facebook [END]

 // GamePot google sigin [START]
 implementation(name: 'gamepot-channel-google-signin', ext: 'aar')
 implementation "com.google.android.gms:play-services-auth:19.0.0"
 // GamePot google sigin [END]
}

// ADD THIS AT THE BOTTOM
apply plugin: 'com.google.gms.google-services'

  3. 请将自Google Developer Center获取的google-service.json文件复制到app文件夹下。

  4. 请刷新Android Studio。

刷新失败时

若尝试刷新时显示通知消息后失败，请按以下方式解决相应问题。

  • 消息： Configuration 'compile' is obsolete and has been replaced with 'implementation' and 'api'. It will be removed at the end of 2018.

For more information see: Add build dependencies | Android Studio | Android Developers 说明：由于不再支持compile设置，因此请将已输入至项目代码的compile部分修改为implementation。

  • 消息：No matching client found for package name '[packagename]' 说明：请将APP的包名称和在google-service.json文件声明的包名称改为一致。

设置AndroidManifest.xml

若要通过设置AndroidManifest.xml添加一般游戏使用的设置值，请使用下列代码。

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:tools="http://schemas.android.com/tools">

    <!--设置为没有通话功能的设备（平板电脑等）也能从商店进行下载-->
    <uses-feature android:name="android.hardware.telephony" android:required="false" />
    <!--设置为没有麦克风的设备也能从商店下载支持语音聊天的游戏-->
    <uses-feature android:name="android.hardware.microphone" android:required="false" />

    <!--allowBackup必须设置为false。若设置为false，重新安装游戏时不会自动恢复shared preference值。-->
    <application
        android:name="androidx.multidex.MultiDexApplication"
        android:allowBackup="false"
        tools:replace="android:allowBackup">

        <!--resizeableActivity: 禁用应用分屏查看功能-->
        <activity
            android:resizeableActivity="false">
            <intent-filter>
                <action android:name="android.intent.action.MAIN" />
                <category android:name="android.intent.category.LAUNCHER" />
            </intent-filter>
        </activity>

        <!--与Galaxy S8屏幕对应-->
        <meta-data android:name="android.max_aspect" android:value="2.1" />

    </application>
</manifest>

设置推送通知图标

可设置接收推送消息时要显示于通知栏的图标。若不额外设置，则使用包含在SDK的默认图片，也可自行设置匹配游戏的图标。若使用Android Asset Studio{target="_blank"}，将自动为各文件夹制作图像，非常便利。

设置推送通知图标的方法如下。

  1. 按照以下方法在项目路径下分别创建res/drawable文件夹后，请根据各文件夹大小添加图像文件。

文件夹名称

大小

res/drawable-mdpi/

24x24

res/drawable-hdpi/

36x36

res/drawable-xhdpi/

48x48

res/drawable-xxhdpi/

72x72

res/drawable-xxxhdpi/

96x96

  1. 请将图像文件名改为ic_stat_gamepot_small。

初始化

若要进行初始化，请在MainActivity.java文件使用下列代码。

import io.gamepot.common.GamePot;
import io.gamepot.common.GamePotLocale;

@Override
protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    // 初始化GAMEPOT。请务必在context输入application context。
    // 请在调用其他API前，首先调用setup API。
    GamePot.getInstance().setup(getApplicationContext());
}

@Override
protected void onActivityResult(int requestCode, int resultCode, Intent data) {
    super.onActivityResult(requestCode, resultCode, data);
    GamePot.getInstance().onActivityResult(requestCode, resultCode, data);
}

@Override
protected void onStart() {
    super.onStart();
    GamePotChat.getInstance().start();
    GamePot.getInstance().onStart(this);
}

@Override
protected void onStop() {
    super.onStop();
    GamePotChat.getInstance().stop();
}

@Override
protected void onDestroy() {
    super.onDestroy();
    GamePot.getInstance().onDestroy();
}
PreviousAndroid SDK_配置要求NextAndroid SDK_登录相关功能

Last updated