京东APP鸿蒙版开发实践，有点牛逼哦！
京东鸿蒙版来了〜
背景
随着鸿蒙2.0的发布，华为部分手机用户迎来鸿蒙时代，京东做为华为鸿蒙OS的合做APP，首次投入鸿蒙应用商用版开发，目前已上架V10.0.2版本。java
鸿蒙OS特性
2021年6月3日，华为举行了鸿蒙OS2.0发布会。鸿蒙OS带来了全新桌面及用户体验，如桌面图标支持上滑呼出快捷卡片，原子化能力能经过鸿蒙设备间流转实现快速分享、显示，以及统一控制中心(手势：右上角下滑)、服务中心(手势：屏幕左下角或右下角向侧上方滑动)等。android
Android工程鸿蒙化
01背景
为了利用上鸿蒙的特性，咱们开发者须要尽快的将App鸿蒙化。可是将整个App鸿蒙化的工做量是特别庞大的，那么有没有一种方式既能利用鸿蒙的特性也能快速适配呢，答案是有的，那就是混合包开发模式，整个App基本上没有大的修改，只须要新增鸿蒙相关模块用来实现鸿蒙相关特性便可。京东App-鸿蒙版可以作到快速适配上线，并拥有鸿蒙特性，就是利用了这种开发模式。下面咱们将以京东App-鸿蒙版为例，具体介绍下相关流程。shell
02Android工程改造
-
咱们须要依赖鸿蒙的一个兼容包(包文件能够联系咱们取得)，将咱们现有的Application继承自HarmonyApplication，仅需编译依赖，不须要真正打进App中。json
compileOnly files('libs/abilityshell_ide_java.jar')
2. 在AndroidManifest.xml中，向根节点下增长。网络
<uses-feature android:name="zidane.software.ability" android:required="false" />
3. 向application节点下新增子节点。app
<meta-data android:name="permZA" android:value="true" /> <meta-data android:name="multiFrameworkBundle" android:value="true" />
自此已经能够构建出鸿蒙须要的apk包了，你们也能够经过配置编译变体等形式，构建鸿蒙版本的apk包。iview
注意：鸿蒙包中混入的apk必需要是64位的。分布式
03配置鸿蒙工程
1.在鸿蒙工程中entry module中的build.gradle里，增长混入apk文件配置。ide
legacyApkOptions{ legacyApk rootProject.file('android_entry.apk').absolutePath //混入apk的存放路径 signConfig{ storeFile rootProject.file('xxx.keystore') //混入apk所用签名文件 } }
总体配置以下图 ：工具
2. 签名改造，咱们须要根据Android apk的签名来作鸿蒙应用签名的申请，须要将.keystore或.jks格式的签名文件转换成.p12文件，签名秘钥和别名保持不变。具体转换步骤，你们能够自行搜索。
参考：在转换.p12文件时，咱们遇到了问题，因为咱们Android的签名格式是.keystore，转出来的.p12文件有问题没法申请鸿蒙应用证书，通过和华为方面沟通，咱们将鸿蒙应用的签名秘钥和别名保持和Android的一致，解决了打包问题。
3. 配置文件增长属性，在鸿蒙工程的每一个feature module的config.json app节点下，增长originalName，表示混入的apk包名，同时要将bundleName的值也改为一致。
4. 在entry模块下，新建一个空的Ability类并配置在config.json里做为启动入口，如：
"abilities": [{ "skills": [{ "entities": ["entity.system.home"], "actions": ["action.system.home"] }], "orientation": "portrait", "visible": true, "name": "com.xxx.xxx.xx.EntryAbility", "icon": "$media:icon", "description": "$string:mainability_description", "label": "$string:app_name", "type": "page", "launchType": "standard" }],
自此已经能够构建出包含原有Android功能的鸿蒙包了。
Android-鸿蒙互调用
01从Android启动鸿蒙组件
咱们须要集成鸿蒙的一个jar包(能够联系咱们得到此文件)，来实现从Android启动鸿蒙的组件。如：
Intent intent = new Intent();ComponentName componentName = new ComponentName("your harmony app's bundleName name","your ability's full name");intent.setComponent(componentName);intent.putExtras(bundle);intent.setFlags(Intent.FLAG_ACTIVITY_NEW_TASK|Intent.FLAG_ACTIVITY_CLEAR_TASK);AbilityUtils.startAbility(context, intent);
02鸿蒙模块调用Android
1. 鸿蒙启动Android组件
鸿蒙里自己是支持启动Android组件的，只须要在Intent里增长一个flag
Intent.FLAG_NOT_OHOS_COMPONENT
如：
Intent intent = new Intent(); Operation operation = new Intent.OperationBuilder() .withDeviceId("") .withBundleName("your android app’s packagename") .withAbilityName("your android app’s activity fullname") .withFlags(Intent.FLAG_NOT_OHOS_COMPONENT) .build(); intent.setOperation(operation); startAbility(intent);
2. 鸿蒙模块调用Android现有能力
在Android包里，已经有了不少现有功能，如埋点收集、用户登陆态获取、定位、地址等等，在鸿蒙模块里须要用到这些功能时，咱们为了节省时间暂时没有再去开发一遍鸿蒙版，咱们利用了Java的反射技术来搞定。通过验证，在Android中反射鸿蒙以及鸿蒙中反射Android都是能够的。
03获取当前是否为鸿蒙系统
在有些场景下，咱们须要知道当前系统的运行环境是否是鸿蒙系统，可使用如下代码段来实现。
private static final String HARMONY_OS = "harmony";/*** check the system is harmony os** @return true if it is harmony os*/public static boolean isHarmonyOS() { try { Class clz = Class.forName("com.huawei.system.BuildEx"); Method method = clz.getMethod("getOsBrand"); return HARMONY_OS.equals(method.invoke(clz)); } catch (ClassNotFoundException e) { Log.e(TAG, "occured ClassNotFoundException"); } catch (NoSuchMethodException e) { Log.e(TAG, "occured NoSuchMethodException"); } catch (Exception e) { Log.e(TAG, "occur other problem"); } return false;}
鸿蒙OS特性+购物应用场景开发
鸿蒙OS打破了设备间的壁垒，对用户及应用开发者来讲，造成了超级终端。超级终端包含手机、大屏、平板，将来或许会有更多的设备加入，设备间协同合做让购物体验变得优质。每一个设备再也不是孤立的个体，而是基于鸿蒙操做系统的智慧终端，即使用户拿着不一样的设备，也能够有很好的体验。经过一键流转实现跨设备间的数据传输，从而实现无缝的购物体验。
01流转：直播间FA
介绍
流转泛指多设备间的分布式操做，打破设备界限，多设备联动，使用户应用程序可分可合、可流转。流转按照体验可分为跨端迁移和多端协同。流转支持免安装运行FA。京东App-鸿蒙版本中的直播FA就利用了流转能力，将当前手机的直播流转至TV端，作到无缝衔接，并支持经过手机端控制TV端直播显示的功能。效果以下：
开发
咱们以京东App-鸿蒙版中直播FA的流转开发经验进行介绍，如何具有流转能力。
1.权限要求
因为使用到了分布式能力，咱们须要先把权限配置好，在对应的module的config.json下，增长如下权限：
ohos.permission.GET_DISTRIBUTED_DEVICE_INFOohos.permission.DISTRIBUTED_DATASYNCohos.permission.DISTRIBUTED_DEVICE_STATE_CHANGE
同时在Ability里，须要增长动态权限申请。
requestPermissionsFromUser( new String[]{SystemPermission.DISTRIBUTED_DATASYNC}, Constants.PermissionCode.PERMISSION_DISTRIBUTED_DATASYNC);
2.关键接口
3.功能实现
a. 经过流转服务注册管理器，将当前FA注册，注册时能够指定流转的过滤条件，如设备类型、目标设备等等：
b. 当须要流转时，咱们经过流转服务注册管理器获取当前知足条件的设备列表：
系统会自动查找设备，将知足条件的设备自动展现出来供用户选择，当用户点击某个设备后，就会回调IContinuationDeviceCallback的onDeviceConnectDone方法，获取到目标设备的Id后，就能够启动目标设备的FA。
c. 启动远程FA
须要注意的是，在启动对端设备上FA时，咱们要确保对端设备的分布式能力已经被初始化。
02FA近场分享：商详FA
介绍
FA近场分享能力依赖于华为分享服务，能够快速实现FA分享的功能。较单纯的使用分布式FA流转功能，为开发者免除了设备发现功能，而且没有了同帐号同网络等限制条件。在京东App-鸿蒙版中，商详FA就使用了此功能实现了FA的近场分享，而且可以作到免安装打开商详页面。下图分别是A向B发送商详FA 和 B接收商详FA。
开发
咱们将以在京东App-鸿蒙版中的相关开发经验介绍下如何进行FA近场分享的开发。
工做原理图示：
因为功能依赖华为分享服务，咱们首先要引入IDL文件。
1. 导入IDL文件
在商详FA module中java同级目录，建立idl目录，并建立包名com.huawei.hwshare.third，在此包名下建立IHwShareCallback.idl和 IHwShareService.idl文件，文件具体内容以下：
IHwShareCallback.idl：interface com.huawei.hwshare.third.IHwShareCallback {
[oneway] void notifyState([in] int state);
}IHwShareService.idl：sequenceable ohos.interwork.utils.PacMapEx;
interface com.huawei.hwshare.third.IHwShareCallback;
interface com.huawei.hwshare.third.IHwShareService {
int startAuth([in] String appId, [in] IHwShareCallback callback); int shareFaInfo([in] PacMapEx pacMapEx);
}
2. 对分享能力进行封装
如下是咱们在商详FA中封装好的代码，你们能够直接使用。
package com.xxx.xxx.xxx;import com.huawei.hwshare.third.HwShareCallbackStub;import com.huawei.hwshare.third.HwShareServiceProxy;import ohos.aafwk.ability.IAbilityConnection;import ohos.aafwk.content.Intent;import ohos.app.Context;import ohos.bundle.ElementName;import ohos.eventhandler.EventHandler;import ohos.eventhandler.EventRunner;import ohos.interwork.utils.PacMapEx;import ohos.rpc.IRemoteObject;import ohos.rpc.RemoteException;import ohos.hiviewdfx.HiLog;import ohos.hiviewdfx.HiLogLabel;public class ShareFaManager { private static final HiLogLabel LABEL_LOG = new HiLogLabel(3, 0xD000F00, "ShareFa"); private static final String LOG_FORMAT = "%{public}s: %{public}s"; // FA的图标 byte[] len < 32768 非必须，不传默认取应用图标 public static final String HM_FA_ICON = "ohos_fa_icon"; // FA的名字 String len < 1024 非必须，不传默认取应用名 public static final String HM_FA_NAME = "ohos_fa_name"; // ability类名 String len < 1024 必须 public static final String HM_ABILITY_NAME = "ohos_ability_name"; // 包名 String len < 1024 必须 public static final String HM_BUNDLE_NAME = "ohos_bundle_name"; // FA类型 int 暂时只有0 非必须，默认为0 public static final String SHARING_FA_TYPE = "sharing_fa_type"; // FA卡片展现图 byte[] len < 153600 必须 public static final String SHARING_THUMB_DATA = "sharing_fa_thumb_data"; // FA卡片展现信息 String len < 1024 必须 public static final String SHARING_CONTENT_INFO = "sharing_fa_content_info"; // 携带的额外信息，可带到被拉起的FA String len < 10240 非必须 public static final String SHARING_EXTRA_INFO = "sharing_fa_extra_info"; private static final String TAG = "ShareHmFaManager"; private static final String SHARE_PKG_NAME = "com.huawei.android.instantshare"; private static final String SHARE_ACTION = "com.huawei.instantshare.action.THIRD_SHARE"; private static final long UNBIND_TIME = 20*1000L; private Context mContext; private String mAppId; private PacMapEx mSharePacMap; private static ShareFaManager sSingleInstance; private HwShareServiceProxy mShareService; private boolean mHasPermission = false; private EventHandler mHandler = new EventHandler(EventRunner.getMainEventRunner()); //服务绑定回调 private final IAbilityConnection mConnection = new IAbilityConnection() { @Override public void onAbilityConnectDone(ElementName elementName, IRemoteObject iRemoteObject, int i) { HiLog.error(LABEL_LOG, LOG_FORMAT, TAG, "onAbilityConnectDone success."); mHandler.postTask(()->{ mShareService = new HwShareServiceProxy(iRemoteObject); try { //华为分享认证受权 mShareService.startAuth(mAppId, mFaCallback); } catch (RemoteException e) { HiLog.error(LABEL_LOG, LOG_FORMAT, TAG, "startAuth error."); } }); } @Override public void onAbilityDisconnectDone(ElementName elementName, int i) { HiLog.info(LABEL_LOG, LOG_FORMAT, TAG, "onAbilityDisconnectDone."); mHandler.postTask(()->{ mShareService = null; mHasPermission = false; }); } }; private Runnable mTask = () -> { if (mContext != null && mShareService != null) { mContext.disconnectAbility(mConnection); mHasPermission = false; mShareService = null; } }; //华为分享认证受权回调 private final HwShareCallbackStub mFaCallback = new HwShareCallbackStub("HwShareCallbackStub") { @Override public void notifyState(int state) throws RemoteException { mHandler.postTask(()->{ HiLog.info(LABEL_LOG, LOG_FORMAT, TAG, "notifyState: " + state); if (state == 0) { mHasPermission = true; if (mSharePacMap != null) { shareFaInfo(); } } }); } }; /** \* 单例模式获取ShareFaManager的实例对象 * \* @param context 程序Context \* @return ShareFaManager实例对象 */ public static synchronized ShareFaManager getInstance(Context context) { if (sSingleInstance == null && context != null) { sSingleInstance = new ShareFaManager(context.getApplicationContext()); } return sSingleInstance; } private ShareFaManager(Context context) { mContext = context; } private void shareFaInfo() { if (mShareService == null) { return; } if (mHasPermission) { HiLog.info(LABEL_LOG, LOG_FORMAT, TAG, "start shareFaInfo."); try { mShareService.shareFaInfo(mSharePacMap); mSharePacMap = null; } catch (RemoteException e) { HiLog.error(LABEL_LOG, LOG_FORMAT, TAG, "shareFaInfo error."); } } // 不使用时断开 mHandler.postTask(mTask, UNBIND_TIME); } /** \* 开始分享 * \* @param appId 开发者联盟网站建立鸿蒙服务/鸿蒙应用时生成的appid \* @param pacMap 服务信息载体 */ public void shareFaInfo(String appId, PacMapEx pacMap) { if (mContext == null) { return; } mAppId = appId; mSharePacMap = pacMap; mHandler.removeTask(mTask); shareFaInfo(); bindShareService(); } /** \* 绑定华为分享服务 */ private void bindShareService() { if (mShareService != null) { return; } HiLog.error(LABEL_LOG, LOG_FORMAT, TAG, "start bindShareService."); Intent intent = new Intent(); intent.setBundle(SHARE_PKG_NAME); intent.setAction(SHARE_ACTION); intent.setFlags(Intent.FLAG_NOT_OHOS_COMPONENT); mContext.connectAbility(intent, mConnection); } }
3.开始分享
咱们将参数进行组装，调用ShareFaManager的shareFaInfo方法便可自动的完成FA分享功能。如咱们将商详FA进行分享：
注意：
1. 使用时要主要传递的数据不要超过限定的大小，不然会分享失败并致使程序崩溃。
2. 在对端接收到分享后，咱们须要将自定义的参数取出来，从Intent中取sharing_fa_extra_info便可。
Ps：针对远距离的场景，华为也给出了解决方案，经过畅连便可分享购物连接。值得注意的是，此时好友还能够经过屏幕共享在商品页面进行涂鸦互动。
03服务卡片：搜索卡片
用户上滑 App 图标便可生成万能卡片 ，在桌面呈现更丰富的信息，卡片信息支持实时更新，减小了 App 加载的时间，如目前京东app，用户上滑 App 图标可打开快捷搜索入口。
介绍
FA卡片是FeatureAbility的Page模板的一种界面展现形式。FA卡片经常使用于嵌入到其余应用中做为其界面的一部分显示，并支持基础的交互功能。卡片使用方做为卡片展现的宿主负责显示卡片，卡片使用方的典型应用就是桌面应用。卡片使用方仅限系统应用。
当FA规格小于10M时，能够支持免安装运行。系统最大支持500个卡片，相同名称的卡片实例最大是32个。
经过服务卡片的一些特色，如定时更新、免安装运行等，能够很好的进行快捷入口的引导。如咱们能够在卡片上展现活动商品，并按期更新，用户能够免安装的打开活动详情，当用户产生进一步购买欲望时，用户可下载整个App进行下单。
开发
卡片的开发支持JS和Java两种方式。在京东App-鸿蒙版中的搜索FA里，咱们加入了FA卡片，能够直达搜索。下面咱们将以此为例进行开发步骤的讲解。
1.卡片配置
首先要在搜索FA的config.json中配置forms节点，好比：
咱们给SearchAbility节点下添加forms节点，就表示这个卡片的建立及管理由SearchAbility来负责。
注意：必需要设置label属性，必须是资源形式的且不能是包名。
属性解释：
2. 实现卡片相关回调
在SearchAbility中，复写如下几个方法：
建立：在建立卡片时，咱们能够从Intent中获取当前要建立卡片的Id,如：
这是一个很简单的卡片，咱们没有对卡片中的视图设置任何数据和事件，那么点击卡片后，打开的就是负责管理卡片的Ability。若是须要设置数据和事件，可使用如下方式
1. 建立ComponentProvider；
2. 经过ComponentProvider设置对应View的数据，以及点击事件，目前可以支持的事件有START_ABILITY和START_SERVICE两类；
3. 将ComponentProvider对象合并入ProviderFormInfo中。
更新：当触发了更新卡片方法时，咱们能够进行数据更新，并将最新的数据更新到卡片View上。
删除：当卡片使用方将卡片删除，咱们可能须要将对应卡片在App内的相关持久化数据进行删除。
3.配置EntryCard目录
配置EntryCard目录，以便让系统可以识别出服务卡片，并展现在服务中心的推荐里。新建应用时能够勾选自动生成，若是是以前IDE建立的工程，则须要手动补充上。
1）在工程根目录下建立EntryCard目录；
2） EntryCard目录下，建立一个文件夹，取名为拥有卡片的FA工程名，如咱们的搜索FA拥有服务卡片，搜索FA的工程名叫searchfeature，那咱们就建立一个文件夹，名字就叫作searchfeature;
3）在searchfeature目录下建立base/snapshot两级目录，在其中放置咱们的卡片图片，其命名方式为formname-dimensions，如搜索卡片的卡片名称配置的是search_card,尺寸是2*2的，那么这个图片就命名为search_card-2x2.png。
鸿蒙App打包及上架
01打包构建
经过以上配置，咱们已经能够进行鸿蒙App的构建了。目前鸿蒙App分为两种构建形式，debug和release，能够经过DevEco工具自带的编译任务或者使用gradle的assembleDebug signReleaseApp任务进行构建。
其中debug模式构建方式出来的产物是多个目标设备的多个.hap文件，每一个FA都会构建出各自的.hap文件；release会构建出一个.app文件，咱们须要将此文件进行上架发布。
安装及运行
1. 开发者没法安装.app安装包，此文件只能用于上架应用市场。
2. 经过adb shell bm get -udid获取设备UDID后，录入到开发者中心，并生成证书文件，咱们就能够安装.hap包。
3. 安装时能够将文件push到手机某个目录下(如sdcard/hmphone)，而后使用adb shell bm install -p /sdcard/hmphone/进行安装，每次安装能够先删除以前文件。
注意：因为咱们没法安装验证.app包，咱们要保证在debug和release两种构建模式下，咱们的代码不会发生改变。
02应用上架及发布
1.若是尚未在开发者中心建立鸿蒙应用的话，须要先新增一个鸿蒙应用，包名和以前Android的包名保持一致，并关联到同一个项目中。
2. 选择咱们建立的鸿蒙应用，在【应用信息】页面中，将应用安装与升级修改成以下图所示。
3. 在【版本信息】页面中，点击【版本/升级】建立新版本，在新版本页面中的【软件版本】模块下，上传咱们构建的.app软件包后并勾选，在当前页面填入相关信息后便可提交审核，待审核经过后，在应用市场上就会出现了。
后续规划
鸿蒙OS为消费者创建便捷的购物超级终端模式提供了可能，随着鸿蒙生态的丰富，人们的购物形式也会随之出现新的改变。京东将从用户角度出发，结合鸿蒙OS，让更多的用户在更多的设备和场景享受京东的优质服务，敬请期待……
— 完 —