【重要】关于倡导鸿蒙生态产品伙伴完成HarmonyOS 鸿蒙Next适配升级公告
【重要】关于倡导鸿蒙生态产品伙伴完成HarmonyOS 鸿蒙Next适配升级公告
HDC 2024 正式启动了HarmonyOS Next的Beta升级，2024年Q4即将商用。为确保鸿蒙生态产品在HarmonyOS Next设备上有更优秀的用户体验，华为终端倡导您作为鸿蒙生态厂家对您自有APP及鸿蒙智联功能做适配升级，否则可能影响生态产品在HarmonyOS Next设备上的正常使用。
以下详细描述：①消费者设备系统升级到HarmonyOS Next后对生态产品H5设备卡片、插件、FA卡片、云云对接及DSL卡片等功能的影响；②基于HarmonyOS NEXT的鸿蒙生态适配方案；以及③不适配可能会产生的影响。
请您仔细评估贵司的产品是否涉及适配，请于7月15日前发送邮件至 harmonyosbd@huawei.com，反馈评估结果及适配计划。如涉及请于2024年9月30日前完成适配并上线。
鸿蒙生态产品HarmonyOS Next适配策略：
· 整体策略
| 分类 | 排查范围 | 判断方法 | HarmonyOS NEXT适配方案 | 适配的技术影响及建议 | |
| 存量设备 | 新购设备 | ||||
| H5单品卡片 | 涉及H5单品卡片的设备 | 有H5单品卡片的都涉及。 | 继承现有智慧生活API接口，其中有9个接口需伙伴根据产品自身使用特性进行评估适配。 | H5卡片的功能都可正常使用，例外场景如下： 生态产品H5详情页少量涉及访问伙伴云、跳转到智慧生活之外页面等三方功能（如跳转vmall购买配件、跳转操作指导视频、跳转地图导航、分享微信朋友圈、上传业务数据到三方云）在HarmonyOS NEXT手机上不能正常使用。 | |
| Native插件 | 涉及使用Native插件开发单品卡片的设备 | 类似单独的APP应用，无法判断的伙伴请联系华为技术支持 | 使用了Native插件的生态产品伙伴需基于HarmonyOS Next适配升级对应的Native插件。 | 1、无法在HarmonyOS Next手机上使用智慧生活APP管理设备（比如无法添加设备/查看视频/打印等），有设备卡片，点击卡片时提示“产品不支持，正在适配中”（具体提示语以实际为准）。 2、如果伙伴有自有的设备管理APP： 1）已适配HarmonyOS NEXT，可用自有APP作为短期应对方案，并反馈华为，在智慧生活APP引导用户切换到伙伴自有APP使用。 2）未适配HarmonyOS NEXT，用户将无法使用HarmonyOS NEXT手机管理/使用这些插件生态设备，需要使用非HarmonyOS NEXT手机管理。 | 1、HarmonyOS NEXT版本智慧生活APP无法添加和管理设备，添加设备时提示“产品不支持，正在适配中”（具体提示语以实际为准） 2、如果伙伴有自有的设备管理APP： 1）已适配HarmonyOS NEXT，可用自有APP作为短期应对方案，并反馈华为，在智慧生活APP引导用户切换到伙伴自有APP使用。 2）未适配HarmonyOS NEXT，用户将无法使用HarmonyOS NEXT手机管理/使用这些插件生态设备，需要使用非HarmonyOS NEXT手机管理。 |
| FA卡片 | HarmonyOS Connect 双连方案 | 华为开发者平台（Device Partner ）上的产品定义页签万能卡片配置项配置为FA的设备。 | 1、使用了FA卡片的生态产品伙伴需基于HarmonyOS Next适配升级自有APP添加设备，然后在智慧生活APP使用。 | 1、用户已添加的设备，可以继续在HarmonyOS NEXT手机的智慧生活APP正常使用。 2、设备重置后，无法使用HarmonyOS NEXT智慧生活APP重新添加。 3、如果伙伴有自有的设备管理APP： 1）已适配HarmonyOS NEXT，通过伙伴自有的设备管理APP添加设备。 2）未适配HarmonyOS NEXT，用户将无法使用HarmonyOS NEXT手机添加设备，需要使用非HarmonyOS NEXT手机添加设备。 | 1、HarmonyOS NEXT终端上智慧生活APP无法添加设备。 2、如果伙伴有自有的设备管理APP： 1）已适配HarmonyOS NEXT，通过伙伴自有的设备管理APP添加设备。 2）未适配HarmonyOS NEXT，用户将无法使用HarmonyOS NEXT手机添加设备，需要使用非HarmonyOS NEXT手机添加设备。 |
| 非HarmonyOS Connect 双连方案 | 1、无需适配升级，使用智慧生活APP扫描添加设备替代。 | 1、在智慧生活APP中查看设备状态和控制等功能可继续正常使用。 2、无法NFC二碰快控功能。 3、设备重置后无法使用NFC碰一碰重新添加，需要使用智慧生活APP扫描添加设备替代。 | 1、使用智慧生活APP扫描添加和控制。 2、无法使用NFC碰一碰添加设备。 | ||
| 纯云云对接 | 纯云云对接产品 | 通过云云对接方式接入鸿蒙智联生态的设备。 | 1、伙伴自有设备管理APP需基于HarmonyOS Next适配升级对应的APP。 2、涉及云云对接双向鉴权的伙伴，HarmonyOS NEXT中伙伴自有设备管理APP的APPID发生变化，需要重新申请云侧对接权限才能继续对接。 | 1、用户已添加的设备，可以继续在HarmonyOS NEXT手机的智慧生活APP正常使用。 2、如果设备重置后，伙伴有自有的设备管理APP未适配HarmonyOS NEXT，需要使用非HarmonyOS NEXT手机自有设备管理APP添加设备。 | 1、伙伴有自有的设备管理APP已适配了HarmonyOS NEXT，可使用自有APP添加设备。 2、伙伴有自有的设备管理APP未适配HarmonyOS NEXT，需要使用非HarmonyOS NEXT手机自有设备管理APP添加设备。 |
| DSL卡片 | 有需要使用HarmonyOS Next新设备卡片能力的存量设备。 | 伙伴配置了DSL卡片功能的产品 | HarmonyOS NEXT手机端新增DSL卡片功能需要伙伴适配升级。 | 1、已有中控屏的DSL卡片功能无影响， 2、HarmonyOS NEXT手机端新增DSL卡片功能需要伙伴适配才能使用，如：1）新增显示的12、 24、4*4桌面单品快快卡片；2）控制中心/系统桌面设备卡片的1.5级快捷控制功能。 2、不影响已有H5设备卡片能力。 | 无影响（新设备，用户看到是最终卡片能力，无法感知到前后变化） |
· H5单品卡片说明
| 接口名称 | 接口描述 | 接口说明 | 不适配的技术影响 | 厂商适配方法 |
| hilink.startApp | hilink.startApp(String packageName, String uri, String data, String action, String resultCallback) | 拉起指定应用的页面。 | 如不适配，HarmonyOS NEXT上无法准确拉起目标应用。另外，HarmonyOS NEXT上目标应用可能暂未鸿蒙化，暂不支持跳转，接口调用会触发暂不支持提醒。 | 需要伙伴整理其产品H5页面调用该接口时，传入的所有参数取值，并反馈给华为，用于华为做接口适配。如果跳转目标应用是厂家开发的应用，则需要厂家做相关应用的鸿蒙化。 |
| hilink.getThirdHmsCode | hilink.getThirdHmsCode(final String resultCallback) | 获取华为账号授权码，被授权的APP ID和Scope从设备profile中获取。 | 如不适配，HarmonyOS NEXT上厂家应用和智慧生活应用中授权状态不同步。 | 如果厂家应用适配HarmonyOS NEXT，需要伙伴在华为应用市场注册HarmonyOS NEXT应用，生成对应APP ID后，联系华为技术支持。 |
| hilink.getHmsCode | hilink.getHmsCode(String appId, String scope, String resultCallback) | 获取华为账号授权码，被授权APP ID和Scope通过H5调用时参数传入。 | 如不适配，HarmonyOS NEXT上厂家应用和智慧生活应用中授权状态不同步。 | 如果厂家应用适配HarmonyOS NEXT，需要伙伴在华为应用市场注册HarmonyOS NEXT应用，生成对应APP ID后，联系华为技术支持。 |
| hilink.goToAbility | hilink.goToAbility(String interactionString) | 支持跳转应用、快应用、内嵌商城单品详情页等。 | 如不适配，HarmonyOS NEXT上将不支持跳转目标页面。另外，HarmonyOS NEXT上跳转目标应用可能暂未鸿蒙化，暂不支持跳转，接口调用会触发暂不支持提醒。 | 需要伙伴整理其产品H5页面调用该接口时，传入的所有参数取值，并反馈给华为，用于华为做接口适配。如果跳转目标应用是厂家开发的应用，则需要厂家做相关应用的鸿蒙化。 |
| hilink.getAbility | String hilink.getAbility(String prodId, String prodType) | 获取单品对应的快服务，单品和快服务关联关系配置在华为智慧生活云，profile中supportHagAbility字段标识是否支持关联快服务。 | HarmonyOS NEXT上伙伴产品H5设备详情页无法获取到其关联的快服务信息。 | 需要伙伴做接口兼容，当接口查询不到信息返回空字符串，建议伙伴隐藏相关跳转入口。 |
| hilink.gotoVmall | hilink.gotoVmall(String suffix) | 跳转到智慧生活内嵌商城指定单品页面。 | HarmonyOS NEXT上智慧生活暂不支持内嵌商城，接口调用会触发暂不支持提醒。 | 如果厂家产品H5页面调用了该接口，需要厂家评估对其产品H5页面功能的影响 |
| hilink.jumpToSharePage | hilink.jumpToSharePage(String url, boolean isShowUser, String resultCallback) | 跳转设备分享页，进行三方应用分享。 | HarmonyOS NEXT上智慧生活暂不支持三方应用分享，接口调用会触发暂不支持提醒。 | 如果厂家产品H5页面调用了该接口，需要厂家评估对其产品H5页面功能的影响 |
| hilink.checkSupportFeatureAbility | hilink.checkSupportFeatureAbility(String resultCallback) | 检查系统是否支持FA。 | HarmonyOS NEXT上智慧生活暂不支持拉起FA卡片，接口调用会返回不支持。 | 如果厂家产品H5页面调用了该接口，需要厂家评估对其产品H5页面功能的影响 |
| hilink.startDevicePageEx | hilink.startDevicePageEx(String bundleName, String abilityName, String data) | 拉起指定的FA。 | HarmonyOS NEXT上智慧生活暂不支持拉起FA卡片，接口调用会触发暂不支持提醒。 | 如果厂家产品H5页面调用了该接口，需要厂家评估对其产品H5页面功能的影响 |
技术总接口人 崔顺 cuishun1@huawei.com
插件 崔顺 cuishun1@huawei.com
FA/云云对接 刘健 liujian257@huawei.com
H5/DSL 王振川 wangzhenchuan1@huawei.com
关于【重要】关于倡导鸿蒙生态产品伙伴完成HarmonyOS 鸿蒙Next适配升级公告的问题，您也可以访问：https://www.itying.com/category-93-b0.html 联系官网客服。
