接入 Android

目前，数据同步组件支持 原生 AAR 接入 和 组件化接入 两种接入方式。

接入过程分为两步：

1. 添加 SDK

2. 使用 SDK

前置条件

您已接入工程到 mPaaS。

• 若采用原生 AAR 方式接入，需要先 将 mPaaS 添加到您的项目中。

• 若采用组件化方式接入，需要先完成 组件化接入流程。

添加 SDK

原生 AAR 方式

参考 AAR 组件管理，通过 组件管理（AAR） 在工程中安装 同步服务（SYNC）组件。

组件化方式

在 Portal 和 Bundle 工程中通过 组件管理 安装 同步服务（SYNC） 组件。

更多信息，请参考 管理组件依赖 > 增删组件依赖。

使用 SDK

在 10.1.32 及以上版本基线中，mPaaS 中间层的 MPSync 类封装了数据同步组件所有 API，通过调用 MPSync 对象即可实现数据同步的所有功能。

您可以通过下表快速了解数据同步的相关 API。更多关于 API 的详细信息，参见 Android 接口说明。

代码示例

该示例通过在 10.1.32 基线版本 SDK 进行开发。在示例应用中设置了一个按钮，通过点按按钮动作获取设备 ID，再根据设备 ID，在控制台采用指定设备推送的方式向设备推送同步数据。在示例中，同步标识为bizType。

    public void button1Clicked(View view)
    {
        //使用 getUtdid 方法获取设备 ID。
        String utdid =UTDevice.getUtdid(MainActivity.this);
        //在 Logcat 打印数据同步数据。
        Log.e("=========",utdid);
        //初始化接口和数据同步服务。
        MPSync.initialize(MainActivity.this);
        //注册接收业务数据的 callback。在获取到同步推送的数据后，回调 syncCallback。
        MPSync.registerBiz("bizType",new SyncCallBackImpl());
        //建立与服务器的网络连接。
        MPSync.appToForeground();

    }

    public class SyncCallBackImpl implements ISyncCallback
    {
        @Override
        public void onReceiveMessage(SyncMessage syncMessage) {
            //在 Logcat 打印数据同步数据。
            Log.e("=========",syncMessage.msgData);
            //通知数据同步服务端接收同步数据成功。
            MPSync.reportMsgReceived(syncMessage);
        }
    }

支持 TLS

在 manifest 中增加 meta-data mss_use_tls 值为 YES，配置非 443 端口也可以支持 TLS 建连。

后续操作

接入服务端