网站导航
> 文档中心 > HarmonyOS实战—亮眼的原子化服务体验

HarmonyOS实战—亮眼的原子化服务体验

网友: 文档中心 2022-03-16 13:53:46

 ##【本文正在参与"有奖征文|HarmoneyOS征文大赛"活动】

他来了他来了,他脚踏祥云走来了。

就像是一声初春的惊雷，响彻在华夏大地，预示着一个崭新的国产化的时代的到来。

我的自豪感也油然而生。谁说国产的不香呢，相信以后国产化也一样可以做到No.1,做到引领潮流，引领世界。

2021年6月2日晚20:00，华为HarmonyOS 2及华为全场景新品发布会如期召开。发布会上，重磅发布了万众瞩目的HarmonyOS 2正式版，HarmonyOS正式到来！

在最新的HarmonyOS 2.0中，"服务卡片"成为一个新的亮点。

其实不止是服务卡片，更是这种原子化服务的理念，简洁，高效，开放，带来的想象力和创新，开启了信息化时代的新的一页，相信以后基于鸿蒙的创新场景，会如雨后春笋般的不断涌现。

什么是服务卡片？

服务卡片（以下简称“卡片”）是一种界面展示形式，将重要信息或操作直接放置到卡片中，用户通过直接操作卡片就可以达到应用的使用体验，这样做大大减少了应用的使用层级性。
卡片常用于嵌入到其他应用中作为其界面的一部分显示（也可以使用原子化服务将应用保存到服务中心中，这种方式不需要安装应用），并支持拉起页面，发送消息等基础的交互功能。

有一下特色：

  1. 全新的Harmonyos桌面简洁有序,上滑App生成服务卡片,在桌面即可呈现更丰富的信息。
  2. 卡片内容实时更新,只需一管即可获取所需信息,省去了打开App的时间。
  3. 卡片可大可小、可藏可显,还能够个性化定制,让每个桌面独一无二。
  4. 卡片也是原子化服务的载体,在服务中心可以轻松获取、随时分享,无需下载、安装,一步到位获取各种服务。

什么是原子化服务？

原子是构成应用的不可再分解的基本服务单元，鸿蒙原子化服务强调的是轻量化服务、免安装应用，也便于为其他应用共享，轻量化的服务可以随意组合，且可有意突出特色化的服务，可为用户提供一个或多个便捷的用户程序形态。试想一个庞大的app有很多服务，都揉合在一个应用中不但操作繁琐，且没有重点，不能有效的吸引用户，里面庞大的百分之七八十的功能可能用户都不关注。且庞大的体系也不利于传播，复用和快速迭代。在平台微服务化，移动端小程序化大行其道火热的今天，华为把类似的概念引入鸿蒙系统，生成一个新的连接场景，提供了更新的想象空间。关于原子化服务的更多内容，参见：HarmonyOS Developer:什么是原子化服务

来看下几个火热的例子：

距离HarmonyOS 2.0发布不到一个月时间，6月25日，国泰君安上线了HarmonyOS原子化服务，一次推出“君弘Lite”、“开户”两个原子化服务卡片。同在6月25日，兴业证券官宣也发布鸿蒙生态服务卡片“优理宝”。

招商银行、中国银行等金融机构此前也官宣上线鸿蒙原子化服务，积极布局开放银行场景新生态。

鸿蒙原子化服务具备免安装、轻量化的特性，其载体为卡片，在服务中心可以轻松获取、随时分享，无需下载、安装。基于 HarmonyOS 2，南航向用户推出“机票预订”和“航班动态”两个原子化服务。其最大特点是用户无需下载“南方航空”App，即可获得与 App 相同的使用体验。

招行银行试着将财富管理的服务从App外延至鸿蒙系统，以App热门栏位“财富直击”为抓手，形成一个原子化服务向客户推荐，当用户看见心仪产品时，即可完成购买。

还有更多的企业不断的在跟进中，大有争先恐后之势。第一次感受到有证券部门比技术部还着急的，因为大凡沾点鸿蒙概念的边，那啥都长飞了。在数字化转型的关键时期，单是在银行业就将迎来一轮新的机遇，借力鸿蒙系统完成应用创新。

服务入口不止是APP，用户在不下载APP的情况下，同样能畅享多种轻应用服务，建立起让用户感觉更亲密的认知和体验。 在全面到来的数字化时代，用户对服务的需求在不同场景及终端，逐步向智能化、便捷化、轻量化转变。

鸿蒙的出现，提供了更新的想象空间，尤其是超级终端理念、轻量化原子服务。

未来，鸿蒙系统带来的全新技术与服务方式，将会进一步加快产品与鸿蒙系统间的融合，从产品、技术、场景联合发力，打造出更多基于鸿蒙生态的特色服务场景。

酝酿了这么多，下面开始进入技术部分的正题，来尝尝鲜。

官方将服务卡片分为三方面：

卡片使用方
显示卡片内容的宿主应用，控制卡片在宿主中展示的位置。
卡片管理服务
用于管理系统中所添加卡片的常驻代理服务，包括卡片对象的管理与使用，以及卡片周期性刷新等。
卡片提供方
提供卡片显示内容的HarmonyOS应用或原子化服务，控制卡片的显示内容、控件布局以及控件点击事件
卡片使用方和提供方不要求常驻运行，在需要添加/删除/请求更新卡片时，卡片管理服务会拉起卡片提供方获取卡片信息。
卡片管理服务

周期性刷新：在卡片添加后，根据卡片的刷新策略启动定时任务周期性触发卡片的刷新。
卡片缓存管理：在卡片添加到卡片管理服务后，对卡片的视图信息进行缓存，以便下次获取卡片时可以直接返回缓存数据，降低时延。
卡片生命周期管理：对于卡片切换到后台或者被遮挡时，暂停卡片的刷新；以及卡片的升级/卸载场景下对卡片数据的更新和清理。
卡片使用方对象管理：对卡片使用方的RPC对象进行管理，用于使用方请求进行校验以及对卡片更新后的回调处理。
卡片提供方

创建卡片实例并实现onCreateForm、onUpdateForm和onDeleteForm处理创建卡片、更新卡片以及删除卡片等请求，提供相应的卡片服务。

服务卡片的实现：

官方文档，官方教程文档见Java卡片开发指导

运行DevEco Studio创建一个新项目，因为要使用java语言，选择支持Java语言。测试起见，选择个空的Ability页面。

接下来创建模板：右击“Entry”→“New”→“Server Widget” 

创建完成之后，在代码的根目录下会自动创建一个widget的文件夹。且自动生成了一些相关代码。

在文件夹中出现了三个文件FormControllerManager.java、FormController.java、CardWidgetImpl.java。

三个文件对应了卡片服务的运行机制，通过关系的对应可以清楚的了解到代码运行原理。

FormControllerManager.java（卡片控制器管理--卡片服务管理）

public class FormControllerManager {    private static final HiLogLabel TAG = new HiLogLabel(HiLog.DEBUG, 0x0, FormControllerManager.class.getName());    private static final String PACKAGE_PATH = "com.example.carddemo.widget";    private static final String SHARED_SP_NAME = "form_info_sp.xml";    private static final String FORM_NAME = "formName";    private static final String DIMENSION = "dimension";    private static FormControllerManager managerInstance = null;    private final HashMap controllerHashMap = new HashMap();    private final Context context;    private final Preferences preferences;    /**     * 初始化构造器     *     * @param context instance of Context.     */    private FormControllerManager(Context context) { this.context = context; DatabaseHelper databaseHelper = new DatabaseHelper(this.context.getApplicationContext()); preferences = databaseHelper.getPreferences(SHARED_SP_NAME);    }    /**     * FormControllerManager 实例化     *     * @param context instance of Context.     * @return FormControllerManager instance.     */    public static FormControllerManager getInstance(Context context) { if (managerInstance == null) {     synchronized (FormControllerManager.class) {  if (managerInstance == null) {      managerInstance = new FormControllerManager(context);  }     } } return managerInstance;    }    /**     * 通过构造器将传入的卡片信息进行封装，返回卡片服务     *     * @param formId    form id.     * @param formName  form name.     * @param dimension form dimension     * @return FormController form controller     */    public FormController createFormController(long formId, String formName, int dimension) { synchronized (controllerHashMap) {     if (formId < 0 || formName.isEmpty()) {  return null;     }     HiLog.info(TAG,      "saveFormId() formId: " + formId + ", formName: " + formName + ", preferences: " + preferences);     if (preferences != null) {  ZSONObject formObj = new ZSONObject();  formObj.put(FORM_NAME, formName);  formObj.put(DIMENSION, dimension);  preferences.putString(Long.toString(formId), ZSONObject.toZSONString(formObj));  preferences.flushSync();     }     // Create controller instance.     FormController controller = newInstance(formName, dimension, context);     // Cache the controller.     if (controller != null) {  if (!controllerHashMap.containsKey(formId)) {      controllerHashMap.put(formId, controller);  }     }     return controller; }    }    /**     * 获取卡片控制器实例     *     * @param formId form id.     * @return the instance of form controller.     */    public FormController getController(long formId) { synchronized (controllerHashMap) {     if (controllerHashMap.containsKey(formId)) {  return controllerHashMap.get(formId);     }     Map forms = preferences.getAll();     String formIdString = Long.toString(formId);     if (forms.containsKey(formIdString)) {  ZSONObject formObj = ZSONObject.stringToZSON((String) forms.get(formIdString));  String formName = formObj.getString(FORM_NAME);  int dimension = formObj.getIntValue(DIMENSION);  FormController controller = newInstance(formName, dimension, context);  controllerHashMap.put(formId, controller);     }     return controllerHashMap.get(formId); }    }    private FormController newInstance(String formName, int dimension, Context context) { FormController ctrInstance = null; if (formName == null || formName.isEmpty()) {     HiLog.error(TAG, "newInstance() get empty form name");     return ctrInstance; } try {     String className = PACKAGE_PATH + "." + formName.toLowerCase(Locale.ROOT) + "."      + getClassNameByFormName(formName);     Class clazz = Class.forName(className);     if (clazz != null) {  Object controllerInstance = clazz.getConstructor(Context.class, String.class, Integer.class)   .newInstance(context, formName, dimension);  if (controllerInstance instanceof FormController) {      ctrInstance = (FormController) controllerInstance;  }     } } catch (NoSuchMethodException | InstantiationException | IllegalArgumentException | InvocationTargetException  | IllegalAccessException | ClassNotFoundException | SecurityException exception) {     HiLog.error(TAG, "newInstance() get exception: " + exception.getMessage()); } return ctrInstance;    }    /**     * 从数组中获取所有卡片id     *     * @return form id list     */    public List getAllFormIdFromSharePreference() { List result = new ArrayList(); Map forms = preferences.getAll(); for (String formId : forms.keySet()) {     result.add(Long.parseLong(formId)); } return result;    }    /**     * 删除卡片服务     *     * @param formId form id     */    public void deleteFormController(long formId) { synchronized (controllerHashMap) {     preferences.delete(Long.toString(formId));     preferences.flushSync();     controllerHashMap.remove(formId); }    }    private String getClassNameByFormName(String formName) { String[] strings = formName.split("_"); StringBuilder result = new StringBuilder(); for (String string : strings) {     result.append(string); } char[] charResult = result.toString().toCharArray(); charResult[0] = (charResult[0] >= 'a' && charResult[0] <= 'z') ? (char) (charResult[0] - 32) : charResult[0]; return String.copyValueOf(charResult) + "Impl";    }}

FormController.java（卡片控制器--卡片提供方）

public abstract class FormController {    protected final Context context;    protected final String formName;    protected final int dimension;    public FormController(Context context, String formName, Integer dimension) { this.context = context; this.formName = formName; this.dimension = dimension;    }    /**     * 创建卡片信息提供者     */    public abstract ProviderFormInfo bindFormData();    /**     * 更新卡片信息     */    public abstract void updateFormData(long formId, Object... vars);    /**     * 在接收服务小部件消息事件时调用     */    public abstract void onTriggerFormEvent(long formId, String message);    /**     * 获取路由的目标界面     */    public abstract Class getRoutePageSlice(Intent intent);}

CardWidgetImpl.java（卡片应用--卡片使用方） 

public class CardWidgetImpl extends FormController {    public static final int DIMENSION_1X2 = 1;    public static final int DIMENSION_2X4 = 3;    private static final HiLogLabel TAG = new HiLogLabel(HiLog.DEBUG, 0x0, CardWidgetImpl.class.getName());    private static final int DEFAULT_DIMENSION_2X2 = 2;    private static final Map RESOURCE_ID_MAP = new HashMap();    static { RESOURCE_ID_MAP.put(DIMENSION_1X2, ResourceTable.Layout_form_grid_pattern_cardwidget_1_2); RESOURCE_ID_MAP.put(DEFAULT_DIMENSION_2X2, ResourceTable.Layout_form_grid_pattern_cardwidget_2_2); RESOURCE_ID_MAP.put(DIMENSION_2X4, ResourceTable.Layout_form_grid_pattern_cardwidget_2_4);    }    public CardWidgetImpl(Context context, String formName, Integer dimension) { super(context, formName, dimension);    }    //创建好卡片服务后，在界面展示卡片    @Override    public ProviderFormInfo bindFormData() { HiLog.info(TAG, "bind form data when create form"); return new ProviderFormInfo(RESOURCE_ID_MAP.get(dimension), context);    }    //更新卡片信息    @Override    public void updateFormData(long formId, Object... vars) { HiLog.info(TAG, "update form data timing, default 30 minutes");    }    //卡片中内容手势触发方法    @Override    public void onTriggerFormEvent(long formId, String message) { HiLog.info(TAG, "handle card click event.");    }    @Override    public Class getRoutePageSlice(Intent intent) { HiLog.info(TAG, "get the default page to route when you click card."); return null;    }}

MainAbility里自动新增了一些方法：

public class MainAbility extends Ability {    public static final int DEFAULT_DIMENSION_2X2 = 2;    public static final int DIMENSION_1X2 = 1;    public static final int DIMENSION_2X4 = 3;    public static final int DIMENSION_4X4 = 4;    private static final int INVALID_FORM_ID = -1;    private static final HiLogLabel TAG = new HiLogLabel(HiLog.DEBUG, 0x0, MainAbility.class.getName());    private String topWidgetSlice;    @Override    public void onStart(Intent intent) { super.onStart(intent); super.setMainRoute(MainAbilitySlice.class.getName()); if (intentFromWidget(intent)) {     topWidgetSlice = getRoutePageSlice(intent);     if (topWidgetSlice != null) {  setMainRoute(topWidgetSlice);     } } stopAbility(intent);    }    //创建卡片信息并返回卡片内容    @Override    protected ProviderFormInfo onCreateForm(Intent intent) { HiLog.info(TAG, "onCreateForm"); long formId = intent.getLongParam(AbilitySlice.PARAM_FORM_IDENTITY_KEY, INVALID_FORM_ID); String formName = intent.getStringParam(AbilitySlice.PARAM_FORM_NAME_KEY); int dimension = intent.getIntParam(AbilitySlice.PARAM_FORM_DIMENSION_KEY, DEFAULT_DIMENSION_2X2); HiLog.info(TAG, "onCreateForm: formId=" + formId + ",formName=" + formName); FormControllerManager formControllerManager = FormControllerManager.getInstance(this); FormController formController = formControllerManager.getController(formId); //通过调用布局Id将卡片布局与卡片信息进行绑定 formController = (formController == null) ? formControllerManager.createFormController(formId,  formName, dimension) : formController; if (formController == null) {     HiLog.error(TAG, "Get null controller. formId: " + formId + ", formName: " + formName);     return null; } return formController.bindFormData();    }    //更新卡片信息    @Override    protected void onUpdateForm(long formId) { HiLog.info(TAG, "onUpdateForm"); super.onUpdateForm(formId); FormControllerManager formControllerManager = FormControllerManager.getInstance(this); FormController formController = formControllerManager.getController(formId); formController.updateFormData(formId);    }    //删除卡片    @Override    protected void onDeleteForm(long formId) { HiLog.info(TAG, "onDeleteForm: formId=" + formId); super.onDeleteForm(formId); FormControllerManager formControllerManager = FormControllerManager.getInstance(this); formControllerManager.deleteFormController(formId);    }    //卡片手势触发    @Override    protected void onTriggerFormEvent(long formId, String message) { HiLog.info(TAG, "onTriggerFormEvent: " + message); super.onTriggerFormEvent(formId, message); FormControllerManager formControllerManager = FormControllerManager.getInstance(this); FormController formController = formControllerManager.getController(formId); formController.onTriggerFormEvent(formId, message);    }    @Override    public void onNewIntent(Intent intent) { if (intentFromWidget(intent)) { // Only response to it when starting from a service widget.     String newWidgetSlice = getRoutePageSlice(intent);     if (topWidgetSlice == null || !topWidgetSlice.equals(newWidgetSlice)) {  topWidgetSlice = newWidgetSlice;  restart();     } }    }    private boolean intentFromWidget(Intent intent) { long formId = intent.getLongParam(AbilitySlice.PARAM_FORM_IDENTITY_KEY, INVALID_FORM_ID); return formId != INVALID_FORM_ID;    }    //跳转至对应的卡片界面    private String getRoutePageSlice(Intent intent) { long formId = intent.getLongParam(AbilitySlice.PARAM_FORM_IDENTITY_KEY, INVALID_FORM_ID); if (formId == INVALID_FORM_ID) {     return null; } FormControllerManager formControllerManager = FormControllerManager.getInstance(this); FormController formController = formControllerManager.getController(formId); if (formController == null) {     return null; } Class clazz = formController.getRoutePageSlice(intent); if (clazz == null) {     return null; } return clazz.getName();    }}

onCreateForm(Intent intent)
onUpdateForm(long formId)
onDeleteForm(long formId)
onCastTempForm(long formId)
onEventNotify(Map formEvents)
在onCreateForm(Intent intent)中，当卡片使用方请求获取卡片时，卡片提供方会被拉起并调onCreateForm(Intent intent)回调，intent中会带有卡片ID，卡片名称，临时卡片标记和卡片外观规格信息，分别通过

AbilitySlice.PARAM_FORM_IDENTITY_KEY、
AbilitySlice.PARAM_FORM_NAME_KEY、
AbilitySlice.PARAM_FORM_TEMORARY_KEY和
AbilitySlice.PARAM_FORM_DIMENSION_KEY按需获取。
提供方可以通过AbilitySlice.PARAM_FORM_CUSTOMIZE_KEY获取卡片使用方设置的自定义数据。当卡片使用方请求获取卡片时，卡片提供方会被拉起并调用onCreateForm回调函数，完成卡片信息的初始化。

onDeleteForm，当卡片被删除时，需要重写onDeleteForm方法，根据卡片id删除卡片实例数据。

卡片使用方:显示卡片内容的宿主应用，控制卡片在宿主中展示的位置。
卡片提供方:提供卡片显示内容的HarmonyOS Service/HarmonyOS Application，控制卡片的显示内容、控件布局以及控件点击事件。

 配置文件config.json里也发生了一些变化。

可以对卡片的界面根据需要更改。

修改form_grid_pattern_cardwidget_1_2、form_grid_pattern_cardwidget_2_2.xml和form_grid_pattern_cardwidget_2_4.xml文件。

最后运行程序，可查看效果。点击图标上划，出现卡片。后续可以进一步完善。使其进行动态的刷新及动态的获取数据。比其传统的一个小应用图标，这种卡片的方式成了一种新的媒介窗口，更有活力和生命力，方便了用户的同时也连通了企业。

更多详细的介绍，参加官方文档：https://developer.harmonyos.com/cn/docs/design/des-guides/service-overview-0000001139795693

其中官方还有个ClockFACardDemo，值得学习。代码参见:https://gitee.com/openharmony/codelabs/tree/master/ClockFACardDemo

网络标签：

相关问题