【Android】shareinstall SDK详细集成方法及注意事项

Shareinstall SDK下载（Android）:

进 官网( 文首已给出)，点击进入下载中中心 ，选择iOS端对应的SDK点击下载即可。

ShareInstallSDK集成:

一、导入SDK

从下载的ShareInstallSdk.zip文件中，将aar文件拷贝到项目的libs文件夹中，并导入。

dependencies {
compile(name: ‘ShareInstall_1.0.6’, ext: ‘aar’)
}
（注：导入aar需检查build文件中是否已经加入以下代码，否则会报错）

repositories {
flatDir {
dirs ‘libs’
}
}

二、基础配置

在AndroidMainfest.xml中添加权限声明。

在AndroidMainfest.xml中的application标签中添加分配给你应用的Appkey

在自定义Application中调用ShareInstall.getInstance().init(context)方法完成SDK初始化，初始化前先判断当前进程是否是应用的主进程。

public class MyApp extends Application {

@Override
public void onCreate() {
    super.onCreate();
    if (isMainProcess()) {
        ShareInstall.getInstance().init(getApplicationContext());
    }
}

/**
* 判断当前进程是否是应用的主进程
*
* @return
*/
public boolean isMainProcess() {
int pid = android.os.Process.myPid();
ActivityManager activityManager = (ActivityManager) getSystemService(Context.ACTIVITY_SERVICE);
for (ActivityManager.RunningAppProcessInfo appProcess : activityManager.getRunningAppProcesses()) {
if (appProcess.pid == pid) {
return getApplicationInfo().packageName.equals(appProcess.processName);
}
}
return false;
}
}
如果使用ShareInstall控制中心提供的注册统计功能，可调用方法 ShareInstall.getInstance().reportRegister(); 注意该方法要在ShareInstall.getInstance().init (context)方法之后调用，否则会抛异常。

// 调用注册接口
ShareInstall.getInstance().reportRegister();
在AndroidMainfest.xml中的application标签中添加android:name=".MyApplication"指定自定义的Application类，以便程序启动的时候初始化自定义Application类，而不是系统默认的Application类。

三、一键跳转

在AndroidMainfest的唤醒页面activity标签中添加intent-filter（一般为MainActivity），配置scheme，用于浏览器中拉起。

注：如果唤醒页面和启动页是同一Activity，则AndroidMaifest.xml的配置如下。

个性化安装和一键唤醒都调用同一个方法ShareInstall.getInstance().getInfo()获取相关信息，第一个参数为Intent(注：Intent可传null，但在配置了scheme唤醒的页面必须传，否则拿不到传递过来的参数)，第二个参数为信息回调监听

四、个性化安装

在APP需要个性化安装参数时（由web网页中传递过来的，如邀请码、游戏房间号等 自定义参数），调用以下方法，在回调中获取参数。

ShareInstall.getInstance().getInfo(intent, new AppGetInfoListener() {
@Override
public void onGetInfoFinish(String info) {
Log.d(“ShareInstall”, "info = " + info);
}
});

五、唤醒页面获取信息

public class WakeUpActivity extends AppCompatActivity {

@Override
protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.activity_wake_up);
    // 获取唤醒参数
    ShareInstall.getInstance().getInfo(getIntent(), listener);
}

@Override
protected void onNewIntent(Intent intent) {
    super.onNewIntent(intent);
    // 此处要调用，否则app在后台运行时，会无法截获
    ShareInstall.getInstance().getInfo(intent, listener);
}

private AppGetInfoListener listener = new AppGetInfoListener() {
    @Override
    public void onGetInfoFinish(String info) {
        Log.d("ShareInstall", "info = " + info);
    }
};

ShareinstallSDK集成测试 :

1、 户注册登录

进 官 ，点击 “控制中 ” 或 “开始使 ” 进 户登录界 ，点击 “登录” 下边的 “还没有账号? 即注册>>” ，按照提示注册登录即可

2、创建应
登录后，点击 “创建应 ”，输 应 名，选择应 类型，点击 “创建” 即可。

3、 配置应
a)创建应 完成后，点击 “详细”，进 应 配置界 ，这时会在界 左上 显示 个

Appkey，这就是你创建的应 对应的Appkey。
b)刚创建的应 需要上传*.ipa包，点击左侧 “集成发布” 下 “安装包托管”，将标签切换到

“IPA托管”
c)第 次上传IPA包时，需要点击 “现在去集成” 按钮，进 集成界 ，将 拉倒底部点击

“ 即上传”，选择要上传的IPA包即可。这时会在 “集成发布” 下 “应 配置” 中 动获取并显示应 的相关配置，你也可以在这 修改应 的相关配置。默认情况下 “启 scheme” 是未勾选的。

4、 安装测试
在“集成发布” 下 “应 配置”中，切换标签到 “iOS配置”，点击 “测试”，在弹出的窗 中，设

置你要在APP安装时传的参数， 动 成 维码。 iPhone扫描 维码，下载安装应 ，在设置->通 进 应 对应的配置 件(描述 件)，选择信任。此时打开应 ，你会看到应 启动后弹出你设置的参数信息(如果你已经修改 获取参数的处 法，将 法弹出信息框)。

此，ShareinstallSDK的集成测试已经完成。

注意：

使用shareinstall控制台提供的在线测试功能，或者自行完成功能测试。如遇到问题可以咨询官方网站，其将提供前期接入的技术支持服务。