1.适用范围
Java8
Kotlin:1.3.11
Gradle:3.1.2
Android Studio:3.2
2.集成准备
在配置CC阅读android客户端前,请先申请阿里热修复,友盟统计,新浪,QQ,微信等第三方平台的appkey,广告目前接入的是广点通广告,如需要,申请广点通广告位。如需推送功能,目前支持小米推送及华为推送,请申请相应功能。
阿里热修复? ?https://help.aliyun.com/product/51340.html
友盟统计? ?https://www.umeng.com
新浪微博? ?https://open.weibo.com/
QQ? ?https://connect.qq.com/index.html
微信? ?https://open.weixin.qq.com/
广点通? ?https://e.qq.com/dev/index.html
小米推送? ?https://dev.mi.com/console/appservice/push.html
华为推送? ?https://developer.huawei.com/consumer/cn/service/hms/pushservice.html
支付宝? ?https://open.alipay.com/platform/home.htm
阿里短信 https://help.aliyun.com/product/44282.html
微信支付? ?https://pay.weixin.qq.com/index.php/core/home/login?return_url=%2F
3.配置文件
1.在Android Studio工程中的App模块中的SophixStubApplication文件中配置阿里热修复的相关信息:
@Override
protected void attachBaseContext(Context base) [
super.attachBaseContext(base);
// 如果需要使用MultiDex,需要在此处调用。
MultiDex.install(this);
initSophix();
]
private void initSophix() [
String appVersion = "0.0.0";
try [
appVersion = this.getPackageManager()
.getPackageInfo(this.getPackageName(), 0)
.versionName;
] catch (Exception e) []
final SophixManager instance = SophixManager.getInstance();
instance.setContext(this)
.setAppVersion(appVersion)
.setSecretMetaData("appkey", "appsecret", "appsecretToken")
.setEnableDebug(true)
.setEnableFullLog()
.setPatchLoadStatusStub(new PatchLoadStatusListener() [
@Override
public void onLoad(final int mode, final int code, final String info, final int handlePatchVersion) [
if (code == PatchStatus.CODE_LOAD_SUCCESS) [
Log.i(TAG, "sophix load patch success!");
] else if (code == PatchStatus.CODE_LOAD_RELAUNCH) [
// 如果需要在后台重启,建议此处用SharePreference保存状态。
Log.i(TAG, "sophix preload patch success. restart app to make effect.");
]
]
]).initialize();
]
如不需要此功能,在AndroidManifest.xml中修改application的name为BookStoreApplication,并在BookStoreApplication类的onCreate方法中注释或删除SophixManager.getInstance().queryAndLoadNewPatch()
2.在Android Studio工程中的App模块中的BookStoreApplication文件中,配置友盟相关信息及三方信息,用于三方登录及分享功能:
UMConfigure.init(this, "友盟key",”渠道”, UMConfigure.DEVICE_TYPE_PHONE, "")
setScenarioType(this, MobclickAgent.EScenarioType.E_UM_NORMAL)
/**
* 设置组件化的Log开关
* 参数: boolean 默认为false,如需查看LOG设置为true
*/
UMConfigure.setLogEnabled(BuildConfig.DEBUG_MODE)
PlatformConfig.setWeixin("appkey", "appsecret")
PlatformConfig.setSinaWeibo("appkey", "appsecret", "授权回调地址")
PlatformConfig.setQQZone("appkey", "appsecret")
注意QQ除了在这儿配置外,在AndroidManifest.xml中也需要配置
/**
* 友盟-QQ
*/
<activity
android:name="com.tencent.tauth.AuthActivity"
android:launchMode="singleTask"
android:noHistory="true">
<intent-filter>
<action android:name="android.intent.action.VIEW" />
<category android:name="android.intent.category.DEFAULT" />
<category android:name="android.intent.category.BROWSABLE" />
<data android:scheme="tencentAPPKEY" />
</intent-filter>
</activity>
在AndroidManifest.xml还需要配置友盟的渠道
/**
* Channel ID用来标识App的推广渠道,作为推送消息时给用户分组的一个维度
*/
<meta-data
android:name="UMENG_CHANNEL"
android:value="$[CHANNEL_VALUE]" />
3.在Android Studio工程中的App模块中的BookStoreApplication文件中,配置推送相关功能。小米推送:
private fun initMiuiPush() [ if (shouldInit()) [ MiPushClient.registerPush(this, "AppID", "AppKey") ] // 打开Log val newLogger = object : LoggerInterface [ override fun setTag(tag: String) [ // ignore ] override fun log(content: String, t: Throwable) [ Log.d(TAG, content, t) ] override fun log(content: String) [ Log.d(TAG, content) ] ] Logger.setLogger(this, newLogger) ] 华为推送主要配置在AndroidManifest.xml中: /** * 华为推送 */ <meta-data android:name="com.huawei.hms.client.appid" android:value="appid=******" /> <meta-data android:name="com.huawei.hms.version" android:value="2.6.1.301" /> 华为推送接收到的数据为scheme类型,需要自信配置相应参数 /** * 接入HMSSDK 需要注册的应用下载服务 | Access HMSSDK need to register app download service */ <service android:name="com.huawei.updatesdk.service.deamon.download.DownloadService" android:exported="false" /> <activity android:name=".book_push.HuaWeiReceiverActivity"> <intent-filter> <action android:name="android.intent.action.VIEW" /> <category android:name="android.intent.category.DEFAULT" /> <data android:host="自定义域名" android:path="/地址" android:scheme="customscheme" /> </intent-filter> </activity>
4.在CommenTag文件中,配置广点通广告:
const val AD_APPKEY = "******" // 开屏页广告位 const val AD_SPLASH_KEY = "******" //阅读页底部广告位 const val AD_BANNER_KEY = "******" //阅读页章节末尾广告位 const val AD_NATIVE_IMAGE = "******" //首页banner最后一页展示广告位 const val AD_NATIVE_BANNER_IMAGE = "******"
5.配置友盟统计多渠道,在config.gradle中定义渠道名称(示例中为渠道cc1/cc2/cc3/cc4)
channel = [ "cc1" : ""cc1"", "cc2" : ""cc2"", "cc3" : ""cc3"", "cc4" : ""cc4"", "cc5" : ""cc5"" ] 在app模块中的build.gradle中引用相应渠道同时,在readviewlibrary中的build.gradle中应用相应渠道 productFlavors [ cc1 [ manifestPlaceholders = [CHANNEL_VALUE:channel["cc1"]] buildConfigField "String", "DEBUG_CHANNEL", channel["cc1"] versionCode rootProject.ext.android_version.ccVersionCode versionName rootProject.ext.android_version.ccVersionName ] cc2 [ manifestPlaceholders = [CHANNEL_VALUE: channel["cc2"]] buildConfigField "String", "DEBUG_CHANNEL", channel["cc2"] versionCode rootProject.ext.android_version.ccVersionCode versionName rootProject.ext.android_version.ccVersionName ] cc3 [ manifestPlaceholders = [CHANNEL_VALUE: channel["cc3"]] buildConfigField "String", "DEBUG_CHANNEL", channel["cc3"] versionCode rootProject.ext.android_version.ccVersionCode versionName rootProject.ext.android_version.ccVersionName ] cc4 [ manifestPlaceholders = [CHANNEL_VALUE: channel["cc4"]] buildConfigField "String", "DEBUG_CHANNEL", channel["cc4"] versionCode rootProject.ext.android_version.ccVersionCode versionName rootProject.ext.android_version.ccVersionName ] ] productFlavors [ cc1 [ buildConfigField "String", "DEBUG_CHANNEL", rootProject.ext.channel["cc1"] ] cc2 [ buildConfigField "String", "DEBUG_CHANNEL", rootProject.ext.channel["cc2"] ] cc3 [ buildConfigField "String", "DEBUG_CHANNEL", rootProject.ext.channel["cc3"] ] cc4 [ buildConfigField "String", "DEBUG_CHANNEL", rootProject.ext.channel["cc4"] ] ] 6.微信支付配置,注意微信登录及微信支付结果回调类WXEntryActivity和WXPayEntryActivity是在包名文件夹下的wxapi中,属于最外层的一级文件夹。
7.关于友盟配置签名文件,在app模块下的build.gradle中配置应用的签名文件
signingConfigs [
debug [
toreFile file("jks文件地址")
storePassword "*********"
keyAlias "*****"
keyPassword "*********"
]
release [
storeFile file("jks文件地址")
storePassword "*******"
keyAlias "*****"
keyPassword "**********"
]
]











;









