unimp小程序V1版 (不支持同时运行多个小程序)

类 DCUniMPSDK

uni小程序SDK入口句柄,该类为工厂模式。通过getInstance()获取对象实例！

DCUniMPSDK 对象的方法介绍

DCUniMPSDK.getInstance()

获取SDK实例

参数说明

无

返回值

DCUniMPSDK.getInstance().initialize(context, config, callback)

sdk初始化

参数说明

返回值

无

示例

MenuActionSheetItem item = new MenuActionSheetItem("关于", "gy");
List<MenuActionSheetItem> sheetItems = new ArrayList<>();
sheetItems.add(item);
DCSDKInitConfig config = new DCSDKInitConfig.Builder()
    .setCapsule(true)
    .setMenuDefFontSize("16px")
    .setMenuDefFontColor("#ff00ff")
    .setMenuDefFontWeight("normal")
    .setMenuActionSheetItems(sheetItems)
    .build();
DCUniMPSDK.getInstance().initialize(this, config, new DCUniMPSDK.IDCUNIMPPreInitCallback() {
    @Override
    public void onInitFinished(boolean isSuccess) {
        Log.e("unimp", "onInitFinished-----------"+isSuccess);
    }
});

DCUniMPSDK.getInstance().isInitialize()

SDK是否初始化成功

参数说明

无

返回值

DCUniMPSDK.getInstance().getAppBasePath(context)

获取uni小程序运行路径

参数说明

返回值

Tips

此接口用于宿主管理应用资源或自释放wgt包集成uni小程序。

自释放wgt包集成uni小程序

宿主通过zip解压wgt包资源。主动释放到uni小程序运行路径下。需要自创建文件应用的APPID/www/的目录

路径格式 : “uni小程序运行路径/应用的APPID/www/wgt包中的资源”

示例

"/xxx/xxx/宿主包名/files/apps/__UNI__04E3A11/www/__UNI__04E3A11.wgt包中的资源"

DCUniMPSDK.getInstance().releaseWgtToRunPathFromePath(appid, wgtPath, callBack)

将wgt包中的资源文件释放到uni小程序运行时路径下。

参数说明

wgtPath参数说明

uni小程序应用资源包路径。例如 “xxx/xxx/xxx/UNI04E3A11.wgt”.

Tips：

• 将不再强校验wgt文件名称。确保appid参数与实际wgt包相符即可。
• 注意使用releaseWgtToRunPathFromePath方法需要申请存储权限：android.permission.WRITE_EXTERNAL_STORAGE

callback返回参数说明

返回值

无

示例

String wgtPath = context.getExternalCacheDir().getPath()+"/__UNI__04E3A11.wgt";
DCUniMPSDK.getInstance().releaseWgtToRunPathFromePath("__UNI__04E3A11", wgtPath, new ICallBack() {
    @Override
    public Object onCallBack(int code, Object pArgs) {
        if(code ==1) {//释放wgt完成
            try {
                DCUniMPSDK.getInstance().startApp(context, "__UNI__04E3A11");
            } catch (Exception e) {
                e.printStackTrace();
            }
        } else{//释放wgt失败
            Toast.makeText(context, "资源释放失败", Toast.LENGTH_SHORT).show();
        }
        return null;
    }
});

DCUniMPSDK.getInstance().setDefMenuButtonClickCallBack(callBack)

设置menu点击事件回调接口

参数说明

callback返回参数说明

返回值

无

示例

DCUniMPSDK.getInstance().setDefMenuButtonClickCallBack(new DCUniMPSDK.IMenuButtonClickCallBack() {
    @Override
    public void onClick(String appid, String id) {
        switch (id) {
            case "gy":{
                Log.e("unimp", "点击了关于" + appid);
                break;
            }
        }
    }
});

DCUniMPSDK.getInstance().getCurrentPageUrl()

2.6.6开始支持此功能

获取运行时uni小程序的当前页面url 可用于页面直达等操作的地址。

参数说明

无

返回值

DCUniMPSDK.getInstance().startApp(context, appid, splashClass, redirectPath, arguments)

启动uni小程序，确保已初始化完毕再调用！可通过DCUniMPSDK.getInstance().isInitialize()判断。

参数说明

redirectPath参数说明

uni小程序页面直达地址。宿主可通过扫码、scheme、网络获取等形式获取相关数据。拼写redirectPath参数，调用startApp实现启动uni小程序直达逻辑。

redirectPath目前由小程序开发者提供。后续SDK将提供分享链接等接口数据。待完善！

格式

redirectPath = pagePath(uni小程序页面路径)+?+query(页面携带参数)

pages/component/scroll-view/scroll-view?a=1&b=2&c=3

返回值

无

示例

// 启动小程序
try {
    DCUniMPSDK.getInstance().startApp(context,"__UNI__04E3A11")
} catch (Exception e) {
    e.printStackTrace();
}

// 启动小程序打开指定页面
try {
    DCUniMPSDK.getInstance().startApp(context,"__UNI__04E3A11",  MySplashView.class, "pages/component/scroll-view/scroll-view?a=1&b=2&c=3");
} catch (Exception e) {
    e.printStackTrace();
}

// 启动小程序并传入参数 "Hello uni microprogram"
try {
    JSONObject arguments = new JSONObject();
    arguments.put("MSG","Hello uni microprogram");
    DCUniMPSDK.getInstance().startApp(context, "__UNI__04E3A11", arguments);
} catch (Exception e) {
    e.printStackTrace();
}

DCUniMPSDK.getInstance().getRuningAppid()

2.6.3开始支持此功能

获取正在运行的uni小程序appid

参数说明

无

返回值

DCUniMPSDK.getInstance().closeCurrentApp()

2.6.3开始支持此功能

关闭当前正在运行的uni小程序

参数说明

无

返回值

DCUniMPSDK.getInstance().setUniMPOnCloseCallBack(callBack)

2.6.3开始支持此功能

小程序被关闭事件监听

参数说明

callback返回参数说明

返回值

无

Tips:

如果您想关闭A小程序后紧接着打开B小程序，在监听小程序被关闭的方法中操作是比较好的时机；

示例:

DCUniMPSDK.getInstance().setUniMPOnCloseCallBack(new DCUniMPSDK.IUniMPOnCloseCallBack() {
    @Override
    public void onClose(String appid) {
        Log.e("unimp", appid+"被关闭了");
    }
});

DCUniMPSDK.getInstance().isExistsApp(appid)

2.7.1 开始支持此功能

检查当前appid小程序是否已释放wgt资源 可用来检查当前appid资源是否存在

参数说明

返回值

DCUniMPSDK.getInstance().getAppVersionInfo(appid)

2.6.6开始支持此功能

获取已运行过的小程序应用版本信息,没有运行过的小程序是无法正常获取到版本信息的。返回值需要判空处理!!!

参数说明

返回值

返回值JSONObject格式说明

{
"name": "1.0.0", //versionName
"code": "100" //versionCode
}

示例:

JSONObject jsonObject = DCUniMPSDK.getInstance().getAppVersionInfo("__UNI__04E3A11");
if(jsonObject != null) {
    Logger.d("__UNI__04E3A11版本信息为"+jsonObject.toString());
}

DCUniMPSDK.getInstance().sendUniMPEvent(event, data)

2.6.10开始支持此功能

宿主主动触发事件到正在运行的小程序。注意：需要已有小程序在运行才可成功

参数说明

返回值

示例:

//JAVA原生层
JSONObject data = new JSONObject();
data.put("sj", "点击了关于");
DCUniMPSDK.getInstance().sendUniMPEvent("gy", data);
//uni小程序JS代码 监听宿主触发给小程序的事件
uni.onNativeEventReceive(function(event, data){
    console.log("onNativeEventReceive----="+event);
});

DCUniMPSDK.getInstance().setOnUniMPEventCallBack(callBack)

2.6.10开始支持此功能

设置监听小程序发送给宿主的事件

参数说明

返回值

无

示例

//小程序js层发送事件给宿主
uni.sendNativeEvent("aa",a, function(e){
    console.log("sendNativeEvent-----------回调"+JSON.stringify(e));
});
//JAVA监听小程序发来的事件 通过callback返回参数
DCUniMPSDK.getInstance().setOnUniMPEventCallBack(new DCUniMPSDK.IOnUniMPEventCallBack() {
    @Override
    public void onUniMPEventReceive(String event, Object data, DCUniMPJSCallback callback) {
        callback.invoke( "测试数据");
    }
});

类 DCSDKInitConfig

uni小程序SDK初始化信息类。需通过DCSDKInitConfig.Builder构建DCSDKInitConfig对象。

类 DCSDKInitConfig.Builder

DCSDKInitConfig的构建者。通过DCSDKInitConfig.Builder().build()创建DCSDKInitConfig实例。

示例

DCSDKInitConfig config = new DCSDKInitConfig.Builder()
                .setCapsule(true)
                .setMenuDefFontSize("16px")
                .setMenuDefFontColor("#ff00ff")
                .setMenuDefFontWeight("normal")
                .setMenuActionSheetItems(sheetItems)
                .build();

DCSDKInitConfig.Builder 对象的方法介绍

setCapsule(isCapsule)

设置是否使用胶囊按钮

注意

uniapp页面没有配置navigationBar或titleNView则不会显示胶囊按钮 两者是绑定关系

参数说明

setEnableBackground(isEnableBackground)

2.8.0 版本开始支持此功能

设置小程序退出时是否进入后台

参数说明

注意事项

开启小程序后台运行功能后，也将开启多任务窗口。效果如下图！如果你的需求不需要小程序有独立任务窗口。那请关闭小程序后台运行功能。 后台模式与多任务窗口两者功能目前是相辅相成。不可分割。

2.8.4+版本支持设置setEnableBackground为false 去除多任务窗口

setMenuDefFontColor(menuDefFontColor)

设置菜单默认按钮文字有颜色

参数说明

setMenuDefFontSize(menuDefFontSize)

设置菜单默认按钮字体大小

参数说明

setMenuDefFontWeight(menuDefFontWeight)

设置菜单默认按钮上文字的粗细

参数说明

setMenuActionSheetItems(list)

设置默认菜单按钮items

参数说明

类MenuActionSheetItem

构造函数 MenuActionSheetItem(title, id)

参数说明

示例

MenuActionSheetItem item = new MenuActionSheetItem("关于", "gy");

接口 IDCUniMPAppSplashView

自定义splashView接口类

IDCUniMPAppSplashView 接口方法介绍

getSplashView(context, appid)

splash创建时会调用此函数

参数说明

返回值

onCloseSplash(rootView)

splash关闭时会调用此函数

参数说明

返回值

无

示例

public class MySplashView implements IDCUniMPAppSplashView {
    FrameLayout splashView;
    @Override
    public View getSplashView(Context context, String appid) {
        splashView = new FrameLayout(context);
        splashView.setBackgroundColor(Color.BLUE);
        return splashView;
    }
    @Override
    public void onCloseSplash(ViewGroup rootView) {
        if(rootView != null)
            rootView.removeView(splashView);
    }
}

DCUniMPJSCallback 2.6.10+新增

小程序js回调接口

invoke(data)

触发js回调(仅一次回调)

参数说明

返回值

无

invokeAndKeepAlive(data)

触发js回调(可多次回调)

参数说明

返回值

无

DCUniMPPermissionUtil

2.8.0 开始支持

小程序权限申请工具

requestPermissions(activity, permissions, requestCode)

权限申请

参数说明

返回值

无