Skip to content

Latest commit

 

History

History
76 lines (55 loc) · 2.83 KB

tinkerpatch-custom-sdk.md

File metadata and controls

76 lines (55 loc) · 2.83 KB
Raw

定制化SDK 接入

作者已不再维护此SDK，建议使用 一键集成SDK

这里只是针对 TinkerPatch SDK的使用说明，对于 Tinker 的基本用法，可参考 Tinker接入指南。

第一步 添加gradle依赖

gradle远程仓库依赖jcenter,例如 Tinker server sample中的build.gradle.

repositories {
    jcenter()
}

再添加sdk库的dependencies依赖:

dependencies {
    compile("com.tencent.tinker:tinkerpatch-sdk:0.3.4")
}

如果使用Tinker 1.7.5的同学，请使用对应的0.3.3版本。0.3.4适配了Tinker 1.7.6的接口更新。

第二步 配置AndroidManifest文件

在AndroidManifest中声明SDK需要的权限：

<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE"/>
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />

第三步 配置AppKey与AppVersion

在 TinkerPatch 平台中得到的 AppKey 以及 AppVersion记住，我们可以简单的将他们写入buildConfig

buildConfigField "String", "APP_KEY", "\"f938475486f91936\""
buildConfigField "String", "APP_VERSION",  "\"3.0.0\""

第四步 初始化 TinkerPatch SDK

我们提供默认的默认的实现，位于TinkerManager和TinkerServerManager. 首先初始化 TinkerPatch 的 SDK，例如 Sample 中 SampleApplicationLike类：

//初始化Tinker
TinkerManager.installTinker(this);
//初始化TinkerPatch SDK
TinkerServerManager.installTinkerServer(
  getApplication(), Tinker.with(getApplication()), 3,
  BuildConfig.APP_KEY, BuildConfig.APP_VERSION, "default"
);
//开始检查是否有补丁，这里配置的是每隔访问3小时服务器是否有更新。
TinkerServerManager.checkTinkerUpdate(false);

SDK 需要Tinker已经初始化，3表示客户端每隔三个小时才会访问服务器一次，具体的 API 将在后面详细说明。 appKey和appVersion为第三部填写的配置，可以通过BuildConfig.APP_KEY和BuildConfig.APP_VERSION得到。 由于GooglePlay渠道的限制，不能使用原生代码下发的机制更新app，我们会过滤channel中含有google的关键字，停止动态更新功能。

如果要使用SDK提供的默认的Service实现，需要在AndroidManifest.xml中声明：

<service
  android:name="com.tencent.tinker.app.service.TinkerServerResultService"
  android:exported="false"
/>

你也可以根据自己的需求实现Manager, 所有与TinkerPatch后台交互的 API 都位于 TinkerServerClient.java中。