Android 小程序 SDK 集成流程
集成准备
获取SDK
请联系工作人员获取小程序对应的Android版本的SDK
开始集成
本文档适用于Android Studio工具
导入SDK
加入AAR
解压SDK压缩包,将aar 放入工程主module的libs目录下。
修改配置
在项目主module的build.gradle中添加依赖。
SDK接入
初始化
方法含义
MiniAppSDK.getInstance().init(activity, miniAppIdAlias, iMiniAppCallback);
SDK的初始化和回调。
参数说明:
属性 | 类型 | 说明 | 是否为空 |
---|---|---|---|
activity | Activity | activity对象 | 不能为空 |
miniAppIdAlias | String | 小程序识别码 | 不能为空 |
iMiniAppCallback | IMiniAppCallback | SDK提供给接入方的接口回调 | 不能为空 |
说明:关于线程的问题说明
接入方调用SDK提供的方法,都需要在UI线程。
SDK提供的回调都在UI线程。
具体处理
详细的处理细节,请参考SDK提供的Sample工程。
MiniAppSDK.getInstance().init(SampleActivity.this, miniAppIdAlias, new IMiniAppCallback() { @Override public MiniAppInitConfig getMiniAppInitConfig() { return null; } @Override public boolean checkMiniAppSslCertification(SslCertificate sslCertificate, String url) { return true; } @Override public void setMiniAppConfig(String localMiniAppVersion, IMiniAppConfigCallback configCallback) { } @Override public void setOfflinePackagePath(String appId, String fullDownloadUrl, String offlinePackagePath, IMiniAppOfflinePackageDownloadCallback downloadCallback) { } @Override public void requestLogin(String appId, IMiniAppLoginCallback iMiniProgramLoginCallback) { } @Override public void requestNetWork(final String appId, final String accessName, final String forwardInfo, final IMiniAppNetWorkForwardCallback iMiniProgramNetWorkForwardCallback) { } @Override public void miniAppError(int error_code, String error_msg) { } @Override public void miniPageOnStart(String appId) { } @Override public void miniPageOnDestroy(String appId) { } });
下面对回调中出现的方法依次进行详细的说明
自定义小程序顶部导航栏样式
初始化配置类MiniAppInitConfig
概要介绍
小程序初始化配置类MiniAppInitConfig, 可通过Builder构建者模式创建,提供的功能如下。
1、自定义小程序顶部导航栏样式 (如:设置导航栏高度)
2、设置小程序默认Icon
3、设置小程序加载页GIF图片
自定义顶部导航栏样式 API
API - navigationBarBackgroundColor
设置顶部导航栏背景颜色。默认颜色值为#3b3f42
接口定义
public Builder navigationBarBackgroundColor(int color)
参数说明
- color:颜色值,为Int类型,注意:非资源ID, resource ID可通过getResources().getColor(R.color.xxx)函数转化
示例代码
MiniAppInitConfig config = new MiniAppInitConfig.Builder() .navigationBarBackgroundColor(color) .build();
API - navigationBarHeight
设置顶部导航栏高度。默认值46dp
接口定义
public Builder navigationBarHeight(int unit,int navigationBarHeight)
参数说明
- unit:尺寸单位,如px、dp等,通过原生类android.util.TypedValue可设置不同的高度单位,如设置dp则为TypedValue.COMPLEX_UNIT_DIP
- navigationBarHeight:高度值大小, 为Int类型,单位为第一个参数unit的值,高度值必须大于0,否则显示高度为默认值大小
示例代码
MiniAppInitConfig config = new MiniAppInitConfig.Builder() .navigationBarHeight(TypedValue.COMPLEX_UNIT_DIP,46) .build();
API - navigationBarTitleName
设置顶部导航栏标题名称。该Title名称也可通过jsbridge调用SDK相关API进行动态设置,若H5界面动态设置该Title名称,则此处设置将被覆盖
接口定义
public Builder navigationBarTitleName(String titleName)
参数说明
- titleName:标题名, 为String字符串类型
示例代码
MiniAppInitConfig config = new MiniAppInitConfig.Builder() .navigationBarTitleName(titleName) .build();
API - navigationBarTitleTextColor
设置顶部导航栏标题字体颜色。默认颜色值为#FFFFFF
接口定义
public Builder navigationBarTitleTextColor(int color)
参数说明
- color:颜色值,为Int类型,注意:非资源ID, resource ID可通过getResources().getColor(R.color.xxx)函数转化
示例代码
MiniAppInitConfig config = new MiniAppInitConfig.Builder() .navigationBarTitleTextColor(color) .build();
API - navigationBarTitleTextSize
设置顶部导航栏标题字体大小。默认值为18sp
接口定义
MiniAppSDK.getInstance().init(SampleActivity.this, miniAppIdAlias, new IMiniAppCallback() { @Override public MiniAppInitConfig getMiniAppInitConfig() { return null; } @Override public boolean checkMiniAppSslCertification(SslCertificate sslCertificate, String url) { return true; } @Override public void setMiniAppConfig(String localMiniAppVersion, IMiniAppConfigCallback configCallback) { } @Override public void setOfflinePackagePath(String appId, String fullDownloadUrl, String offlinePackagePath, IMiniAppOfflinePackageDownloadCallback downloadCallback) { } @Override public void requestLogin(String appId, IMiniAppLoginCallback iMiniProgramLoginCallback) { } @Override public void requestNetWork(final String appId, final String accessName, final String forwardInfo, final IMiniAppNetWorkForwardCallback iMiniProgramNetWorkForwardCallback) { } @Override public void miniAppError(int error_code, String error_msg) { } @Override public void miniPageOnStart(String appId) { } @Override public void miniPageOnDestroy(String appId) { } });
0
参数说明
- unit:尺寸单位,如px、dp等,通过原生类android.util.TypedValue可设置不同的高度单位,如设置dp则为TypedValue.COMPLEX_UNIT_DIP
- textSize:文字字体大小,值为float类型,传入的值必须大于0,否则显示为默认字体大小18sp
示例代码
MiniAppSDK.getInstance().init(SampleActivity.this, miniAppIdAlias, new IMiniAppCallback() { @Override public MiniAppInitConfig getMiniAppInitConfig() { return null; } @Override public boolean checkMiniAppSslCertification(SslCertificate sslCertificate, String url) { return true; } @Override public void setMiniAppConfig(String localMiniAppVersion, IMiniAppConfigCallback configCallback) { } @Override public void setOfflinePackagePath(String appId, String fullDownloadUrl, String offlinePackagePath, IMiniAppOfflinePackageDownloadCallback downloadCallback) { } @Override public void requestLogin(String appId, IMiniAppLoginCallback iMiniProgramLoginCallback) { } @Override public void requestNetWork(final String appId, final String accessName, final String forwardInfo, final IMiniAppNetWorkForwardCallback iMiniProgramNetWorkForwardCallback) { } @Override public void miniAppError(int error_code, String error_msg) { } @Override public void miniPageOnStart(String appId) { } @Override public void miniPageOnDestroy(String appId) { } });
1
API - navigationBarMoreImage
设置顶部导航栏右侧 “更多” 按钮图片,默认为". . .",三个白色小点按钮。
接口定义
MiniAppSDK.getInstance().init(SampleActivity.this, miniAppIdAlias, new IMiniAppCallback() { @Override public MiniAppInitConfig getMiniAppInitConfig() { return null; } @Override public boolean checkMiniAppSslCertification(SslCertificate sslCertificate, String url) { return true; } @Override public void setMiniAppConfig(String localMiniAppVersion, IMiniAppConfigCallback configCallback) { } @Override public void setOfflinePackagePath(String appId, String fullDownloadUrl, String offlinePackagePath, IMiniAppOfflinePackageDownloadCallback downloadCallback) { } @Override public void requestLogin(String appId, IMiniAppLoginCallback iMiniProgramLoginCallback) { } @Override public void requestNetWork(final String appId, final String accessName, final String forwardInfo, final IMiniAppNetWorkForwardCallback iMiniProgramNetWorkForwardCallback) { } @Override public void miniAppError(int error_code, String error_msg) { } @Override public void miniPageOnStart(String appId) { } @Override public void miniPageOnDestroy(String appId) { } });
2
参数说明
- 三个重载函数,分别支持以resourceId、以drawable对象、以bitmap对象的形式设置,开发者调用其中一种方式设置即可
示例代码
以resourceId的方式设置为例
MiniAppSDK.getInstance().init(SampleActivity.this, miniAppIdAlias, new IMiniAppCallback() { @Override public MiniAppInitConfig getMiniAppInitConfig() { return null; } @Override public boolean checkMiniAppSslCertification(SslCertificate sslCertificate, String url) { return true; } @Override public void setMiniAppConfig(String localMiniAppVersion, IMiniAppConfigCallback configCallback) { } @Override public void setOfflinePackagePath(String appId, String fullDownloadUrl, String offlinePackagePath, IMiniAppOfflinePackageDownloadCallback downloadCallback) { } @Override public void requestLogin(String appId, IMiniAppLoginCallback iMiniProgramLoginCallback) { } @Override public void requestNetWork(final String appId, final String accessName, final String forwardInfo, final IMiniAppNetWorkForwardCallback iMiniProgramNetWorkForwardCallback) { } @Override public void miniAppError(int error_code, String error_msg) { } @Override public void miniPageOnStart(String appId) { } @Override public void miniPageOnDestroy(String appId) { } });
3
API - navigationBarCloseImage
设置顶部导航栏右侧 “关闭” 按钮图片,默认为"X"型图片
接口定义
MiniAppSDK.getInstance().init(SampleActivity.this, miniAppIdAlias, new IMiniAppCallback() { @Override public MiniAppInitConfig getMiniAppInitConfig() { return null; } @Override public boolean checkMiniAppSslCertification(SslCertificate sslCertificate, String url) { return true; } @Override public void setMiniAppConfig(String localMiniAppVersion, IMiniAppConfigCallback configCallback) { } @Override public void setOfflinePackagePath(String appId, String fullDownloadUrl, String offlinePackagePath, IMiniAppOfflinePackageDownloadCallback downloadCallback) { } @Override public void requestLogin(String appId, IMiniAppLoginCallback iMiniProgramLoginCallback) { } @Override public void requestNetWork(final String appId, final String accessName, final String forwardInfo, final IMiniAppNetWorkForwardCallback iMiniProgramNetWorkForwardCallback) { } @Override public void miniAppError(int error_code, String error_msg) { } @Override public void miniPageOnStart(String appId) { } @Override public void miniPageOnDestroy(String appId) { } });
4
参数说明
- 三个重载函数,分别支持以resourceId、以drawable对象、以bitmap对象的形式设置,开发者调用其中一种方式设置即可
示例代码
以resourceId的方式设置为例
MiniAppSDK.getInstance().init(SampleActivity.this, miniAppIdAlias, new IMiniAppCallback() { @Override public MiniAppInitConfig getMiniAppInitConfig() { return null; } @Override public boolean checkMiniAppSslCertification(SslCertificate sslCertificate, String url) { return true; } @Override public void setMiniAppConfig(String localMiniAppVersion, IMiniAppConfigCallback configCallback) { } @Override public void setOfflinePackagePath(String appId, String fullDownloadUrl, String offlinePackagePath, IMiniAppOfflinePackageDownloadCallback downloadCallback) { } @Override public void requestLogin(String appId, IMiniAppLoginCallback iMiniProgramLoginCallback) { } @Override public void requestNetWork(final String appId, final String accessName, final String forwardInfo, final IMiniAppNetWorkForwardCallback iMiniProgramNetWorkForwardCallback) { } @Override public void miniAppError(int error_code, String error_msg) { } @Override public void miniPageOnStart(String appId) { } @Override public void miniPageOnDestroy(String appId) { } });
5
设置小程序默认Icon API
API - miniAppDefaultIcon
设置小程序默认Icon,用于在"关于小程序"页面,当网络加载小程序Icon出错时显示
接口定义
MiniAppSDK.getInstance().init(SampleActivity.this, miniAppIdAlias, new IMiniAppCallback() { @Override public MiniAppInitConfig getMiniAppInitConfig() { return null; } @Override public boolean checkMiniAppSslCertification(SslCertificate sslCertificate, String url) { return true; } @Override public void setMiniAppConfig(String localMiniAppVersion, IMiniAppConfigCallback configCallback) { } @Override public void setOfflinePackagePath(String appId, String fullDownloadUrl, String offlinePackagePath, IMiniAppOfflinePackageDownloadCallback downloadCallback) { } @Override public void requestLogin(String appId, IMiniAppLoginCallback iMiniProgramLoginCallback) { } @Override public void requestNetWork(final String appId, final String accessName, final String forwardInfo, final IMiniAppNetWorkForwardCallback iMiniProgramNetWorkForwardCallback) { } @Override public void miniAppError(int error_code, String error_msg) { } @Override public void miniPageOnStart(String appId) { } @Override public void miniPageOnDestroy(String appId) { } });
6
参数说明
- 三个重载函数,分别支持以resourceId、以drawable对象、以bitmap对象的形式设置,开发者调用其中一种方式设置即可
示例代码
以resourceId的方式设置为例
MiniAppSDK.getInstance().init(SampleActivity.this, miniAppIdAlias, new IMiniAppCallback() { @Override public MiniAppInitConfig getMiniAppInitConfig() { return null; } @Override public boolean checkMiniAppSslCertification(SslCertificate sslCertificate, String url) { return true; } @Override public void setMiniAppConfig(String localMiniAppVersion, IMiniAppConfigCallback configCallback) { } @Override public void setOfflinePackagePath(String appId, String fullDownloadUrl, String offlinePackagePath, IMiniAppOfflinePackageDownloadCallback downloadCallback) { } @Override public void requestLogin(String appId, IMiniAppLoginCallback iMiniProgramLoginCallback) { } @Override public void requestNetWork(final String appId, final String accessName, final String forwardInfo, final IMiniAppNetWorkForwardCallback iMiniProgramNetWorkForwardCallback) { } @Override public void miniAppError(int error_code, String error_msg) { } @Override public void miniPageOnStart(String appId) { } @Override public void miniPageOnDestroy(String appId) { } });
7
设置小程序加载页gif图片 API
API - setLoadingGifImage
设置小程序加载页gif图片,网络加载HTML未成功前,将显示加载页,提醒用户正在加载,不自定义gif图片,则使用SDK默认的gif图片
接口定义
MiniAppSDK.getInstance().init(SampleActivity.this, miniAppIdAlias, new IMiniAppCallback() { @Override public MiniAppInitConfig getMiniAppInitConfig() { return null; } @Override public boolean checkMiniAppSslCertification(SslCertificate sslCertificate, String url) { return true; } @Override public void setMiniAppConfig(String localMiniAppVersion, IMiniAppConfigCallback configCallback) { } @Override public void setOfflinePackagePath(String appId, String fullDownloadUrl, String offlinePackagePath, IMiniAppOfflinePackageDownloadCallback downloadCallback) { } @Override public void requestLogin(String appId, IMiniAppLoginCallback iMiniProgramLoginCallback) { } @Override public void requestNetWork(final String appId, final String accessName, final String forwardInfo, final IMiniAppNetWorkForwardCallback iMiniProgramNetWorkForwardCallback) { } @Override public void miniAppError(int error_code, String error_msg) { } @Override public void miniPageOnStart(String appId) { } @Override public void miniPageOnDestroy(String appId) { } });
8
参数说明
- resourceId: gif图片的资源id,若只想改变图片宽高,使用SDK默认gif资源,resourceId值则填入MiniAppInitConfig.DEFAULT_LOADING_RESOURCES即可
- widthUnit:尺寸单位,如px、dp等,通过原生类android.util.TypedValue可设置不同的宽度单位,如设置dp则为TypedValue.COMPLEX_UNIT_DIP
- heightUnit:尺寸单位,如px、dp等,通过原生类android.util.TypedValue可设置不同的高度单位,如设置dp则为TypedValue.COMPLEX_UNIT_DIP
- imageWidth: 设置gif图片的宽度, 为Int类型,单位取决于widthUnit的值
- imageHeight: 设置gif图片的高度,为Int类型,单位取决于imageHeight的值
示例代码
以dp为尺寸单位设置为例
MiniAppSDK.getInstance().init(SampleActivity.this, miniAppIdAlias, new IMiniAppCallback() { @Override public MiniAppInitConfig getMiniAppInitConfig() { return null; } @Override public boolean checkMiniAppSslCertification(SslCertificate sslCertificate, String url) { return true; } @Override public void setMiniAppConfig(String localMiniAppVersion, IMiniAppConfigCallback configCallback) { } @Override public void setOfflinePackagePath(String appId, String fullDownloadUrl, String offlinePackagePath, IMiniAppOfflinePackageDownloadCallback downloadCallback) { } @Override public void requestLogin(String appId, IMiniAppLoginCallback iMiniProgramLoginCallback) { } @Override public void requestNetWork(final String appId, final String accessName, final String forwardInfo, final IMiniAppNetWorkForwardCallback iMiniProgramNetWorkForwardCallback) { } @Override public void miniAppError(int error_code, String error_msg) { } @Override public void miniPageOnStart(String appId) { } @Override public void miniPageOnDestroy(String appId) { } });
9
创建MiniAppInitConfig对象示例代码
public Builder navigationBarBackgroundColor(int color)
0
注意:若未初始化该Config对象,或者个别配置未设置,则会使用SDK内默认配置
获取小程序配置信息
说明:SDK请求接入方从网络上获取当前小程序的配置信息,接入方请求完毕后,将返回数据告知SDK
这个在回调中的setMiniAppConfig
方法中触发。
下面对setMiniAppConfig
方法进行详细说明:
public Builder navigationBarBackgroundColor(int color)
1
方法含义
SDK请求接入方从网络上获取当前小程序的配置信息,接入方请求完毕后,将返回数据告知SDK(包括成功,失败)
参数说明
属性 | 类型 | 说明 |
---|---|---|
localMiniAppVersion | String | 本地数据库中当前小程序的版本,用于网络请求中请求版本参数 |
configCallback | IMiniAppConfigCallback | SDK提供给接入方的设置配置数据的接口引用 |
具体处理
接入方获取当前的小程序配置信息 请求参数有两个
1.code
:当前小程序的识别码
2.version
:当前小程序的版本,值为回调中的参数localMiniAppVersion
.
具体网络接口的详细说明,请查看小程序服务端文档
当配置接口请求完成后,进行如下的转换,将请求结果告知SDK
public Builder navigationBarBackgroundColor(int color)
2
下载小程序离线包
说明:SDK通知接入方下载离线包,并将下载后的结果告知SDK
在回调中的setOfflinePackagePath
方法中触发
下面对setOfflinePackagePath
方法进行详细说明: 1.方法含义
public Builder navigationBarBackgroundColor(int color)
3
SDK通知接入方下载离线包,并将下载后的结果告知SDK
参数说明
属性 | 类型 | 说明 |
---|---|---|
appId | String | 小程序id |
fullDownloadUrl | String | 小程序全量离线包下载地址url |
offlinePackageStorageDirectory | String | 下载完成后离线包的存储目录 |
offlinePackageName | String | 下载后离线包需要重命名的名字 |
downloadCallback | IMiniAppOfflinePackageDownloadCallback | SDK提供给接入方的下载完成接口引用 |
具体处理
1.接入方使用fullDownloadUrl
进行离线包下载
2.下载成功后,将离线包重新命名为offlinePackageName
,将其保存在offlinePackageStorageDirectory
这个路径下
3.下载成功调用downloadCallback.setOfflinePackagePath(offlinePackagePath+"/"+offlinePackageName);
方法
4.下载失败后调用downloadCallback.downloadError(errorMsg)
,其中errorMsg为下载失败的原因
小程序请求登录
说明:SDK请求接入方进行登录,然后将结果告诉SDK
这个会在回调中的requestLogin
方法中触发。
下面对requestLogin
方法进行详细说明 方法含义
public Builder navigationBarBackgroundColor(int color)
4
SDK请求接入方进行登录,然后将结果告诉SDK
参数说明
属性 | 类型 | 说明 |
---|---|---|
appId | String | 小程序id |
loginCallback | IMiniAppLoginCallback | SDK提供给接入方的登录完成后回调的接口引用 |
具体处理
登录成功:
public Builder navigationBarBackgroundColor(int color)
5
登录失败
public Builder navigationBarBackgroundColor(int color)
6
小程序请求接口转发
说明:小程序内网络请求的转发,请进行网络请求,并将结果告诉SDK
这个在回调中的requestNetWork
方法中触发。
方法含义
public Builder navigationBarBackgroundColor(int color)
7
小程序内网络请求的转发,请进行网络请求,并将结果告诉SDK
参数说明
属性 | 类型 | 说明 |
---|---|---|
appId | String | 小程序id |
accessName | String | 拼接URL时使用 |
forwardCallback | IMiniAppNetWorkForwardCallback | SDK提供给接入方的接口转发完成后回调的接口引用 |
具体处理
请求URL的完整格式为:
public Builder navigationBarBackgroundColor(int color)
8
例如: 转发接口的host
如下:
public Builder navigationBarBackgroundColor(int color)
9
请求转发的forwardInfoJsonString
字段值如下:
MiniAppInitConfig config = new MiniAppInitConfig.Builder() .navigationBarBackgroundColor(color) .build();
0
forwardInfoJsonString的格式参数说明
forwardInfoJsonString为一个Json格式的字符串. 例如:
MiniAppInitConfig config = new MiniAppInitConfig.Builder() .navigationBarBackgroundColor(color) .build();
0
字段含义说明
属性 | 类型 | 默认值 | 必填 | 说明 | 最低版本 |
---|---|---|---|---|---|
url | string | 是 | 开发者服务器接口地址 | ||
data | string/object | 否 | 请求的参数 | ||
method | string | POST | 否 | HTTP 请求方法 | |
dataType | string | json | 否 | 返回的数据格式 | |
responseType | string | text | 否 | 响应的数据类型 | |
encrypted | boolean/string | false | 否 | 是否加密 | |
cipherFlag | string | 否 | 加密方式 |
method 参数的合法值
值 | 说明 | 最低版本 |
---|---|---|
GET | HTTP 请求 GET | |
POST | HTTP 请求 POST |
dataType 参数的合法值
小程序sdk不用关心,前端处理
值 | 说明 | 最低版本 |
---|---|---|
json | 返回的数据为 JSON,返回后会对返回的数据进行一次 JSON.parse | |
其他 | 不对返回的内容进行 JSON.parse |
responseType 参数的合法值
值 | 说明 | 最低版本 |
---|---|---|
text | 响应的数据为文本 |
encrypted 参数的合法值
值 | 说明 | 最低版本 |
---|---|---|
false或者空 | 不加密 | |
true | 加密 |
cipherFlag 参数的合法值
encrypted为false或空时不传该字段
值 | 说明 | 最低版本 |
---|---|---|
002 | 登陆后交易使用的加密 | |
005 | 登陆前交易使用的加密 |
success 回调参数:
属性 | 类型 | 说明 | 最低版本 |
---|---|---|---|
data | string/Object/Arraybuffer | 开发者服务器返回的数据 | |
statusCode | number | 开发者服务器返回的 HTTP 状态码 | |
header | Object | 开发者服务器返回的 HTTP Response Header |
fail 回调参数:
属性 | 类型 | 说明 | 最低版本 |
---|---|---|---|
error | Object | 开发者服务器返回的错误信息,包括code错误码, msg错误信息字段 |
那么转发请求的完整的URL如下:
MiniAppInitConfig config = new MiniAppInitConfig.Builder() .navigationBarBackgroundColor(color) .build();
2
小程序错误回调
说明:小程序SDK统一的错误回调,包括接入方传入的参数不合法,包括SDK内部的异常. 这个在回调中的
miniAppError
方法中触发
下面对miniAppError
方法进行详细说明: 方法含义
小程序SDK统一的错误回调,包括接入方传入的参数不合法,包括SDK内部的异常
参数说明
MiniAppInitConfig config = new MiniAppInitConfig.Builder() .navigationBarBackgroundColor(color) .build();
3
error_code:错误码 error_msg:错误信息
具体处理
MiniAppInitConfig config = new MiniAppInitConfig.Builder() .navigationBarBackgroundColor(color) .build();
4
错误码说明
错误码 | 说明 |
---|---|
100 | 配置接口传递的map==null |
101 | 配置接口返回数据错误 |
102 | 配置接口返回Json数据异常! response==null |
103 | 小程序配置Json中 miniAppId is empty |
104 | 小程序配置Json中 miniAppVersion is empty |
105 | 小程序配置Json中 fullDownloadUrl is empty |
106 | 小程序配置Json中 fullMd5 is empty |
107 | 小程序配置Json中 loadType is empty |
108 | 小程序配置Json中 urlPrefix is empty |
109 | 小程序配置Json中 sdkMinVer is empty |
110 | 小程序配置Json中 sdkMinVer 不是一个数字 |
111 | 小程序配置Json中 accessName is empty |
112 | 小程序配置Json中 miniAppIdAlias is empty |
200 | 当前SDK不支持该小程序,请升级SDK版本 |
201 | 客户端获取Config信息失败 |
300 | 客户端下载离线包失败 |
301 | 客户端传递的小程序离线包存储地址为空 |
302 | 小程序离线包不存在 |
303 | 小程序离线包,压缩文件md5值和配置接口中返回的不一致 |
304 | 小程序解压目录中没有文件 |
305 | 小程序解压失败 |
306 | 解压文件中包含非法字符 |
400 | 加载的文件中出现了sha1不一致的情况 |
小程序生命周期
说明:小程序SDK对外提供生命周期的两个回调。分别是开始加载和关闭。 分别对应着回调中的
miniPageOnStart
方法和miniPageOnDestroy
方法
下面分别对这两个方法进行详细的说明
回调中的miniPageOnStart
方法
方法含义
MiniAppInitConfig config = new MiniAppInitConfig.Builder() .navigationBarBackgroundColor(color) .build();
5
小程序界面开始加载的回调.
参数说明
属性 | 类型 | 说明 |
---|---|---|
appId | String | 小程序id |
具体处理
可以根据自己的业务,进行统计等等处理.
回调中miniPageOnDestroy
方法
方法含义
MiniAppInitConfig config = new MiniAppInitConfig.Builder() .navigationBarBackgroundColor(color) .build();
6
小程序界面关闭的回调.
参数说明
属性 | 类型 | 说明 |
---|---|---|
appId | String | 小程序id |
具体处理
可以根据自己的业务,进行统计等等处理.
小程序日志控制
SDK提供了Log日志开关的方法MiniAppLog.setDebug()
SDK内部的日志,默认是开着的,建议在release模式下关闭日志。
MiniAppInitConfig config = new MiniAppInitConfig.Builder() .navigationBarBackgroundColor(color) .build();
7
小程序版本
SDK提供获取当前的版本号,方便调试。
MiniAppInitConfig config = new MiniAppInitConfig.Builder() .navigationBarBackgroundColor(color) .build();
8
还没有评论,来说两句吧...