1、 版权所有 华为技术有限公司 第 1 页 , 共 10 页 华为桌面角标 开发 指导书 文档版本： v1.0.0 版权所有 华为技术有限公司 第 2 页 , 共 10 页 版权所有 华为技术有限公司 2015。 保留一切权利。 非经本公司书面许可，任何单位和个人不得擅自摘抄、复制本文档内容的部分或全部，并不得以任何形式传播。 商标声明 和其他华为商标均为华为技术有限公司的商标。 本文档提及的其他所有商标或注册商标，由各自的所有人拥有。 注意 您购买的产品、服务或特性等应受华为公司商业合同和条款的约束，本文档中描述的全部或部分产品、服务或特性可能不在您的购买或使用范围之内。除非合同另有约定，华为
2、公司对本文档内容不做任何明示或默示的声明或保证。 由于产品版本升级或其他原因，本文档内容会不定期进行更新。除非另有约定，本文档仅作为使用指导，本文档中的所有陈述、信息和建议不构成任何明示或暗示的担保。 版权所有 华为技术有限公司 第 3 页 , 共 10 页 修改记录 日期 版本 修改描述 2016-2-22 v1.0.0 初稿 版权所有 华为技术有限公司 第 4 页 , 共 10 页 目录 1 概述 . 5 1.1 架构 . 5 1.2 支持平台 . 5 2 角标功能开发指南 . 5 2.1 开发者应用修改 . 5 2.1.1 AndroidManifest.xml 修改 . 5 2.1.2
3、 编写源码调用角标接口 . 5 2.2 申请华为证书 . 6 2.3 将华为证书打包到开发者应用中 . 9 2.4 注意事项 . 9 3 FAQ . 9 版权所有 华为技术有限公司 第 5 页 , 共 10 页 1 概述 角标是华为桌面提供给各应用 显示 未读 消息 用的 ,会在应用图标右上角绘制一张消息条数的图标 . 1.1 架构 下图展示了 华为 桌面角标 SDK 的架构。 桌 面 应 用提 供 接 口调 用 角 标 接 口绘 制 角 标1.2 支持平台 系统 版本： EMUI4.1 及以上 桌面版本： 6.3.29 2 角标 功能开发 指南 2.1 开发者 应用 修改 2.1.1 And
4、roidManifest.xml 修改 在开发者的 AndroidManifest.xml 中，增加 作用：调用 launcher接口 方法所需权限。 作用：安装时系统依据此权限识别该应用的证书，并且动态分配权限。 2.1.2 编写源码调用角标接口 1. 目前华为桌面并非每个版本都支持该接口，考虑兼容性，可以先判断桌面是否支持角标，然后再调用角标接口显示角标。 可以依据桌面版本号来判断桌面是否支持角标，目前桌面支持角标的最低版本号为 63029，参考方法如下： 版权所有 华为技术有限公司 第 6 页 , 共 10 页 boolean isSupportedBade = false; publi
5、c void checkIsSupportedByVersion() try PackageManager manager = getPackageManager(); PackageInfo info = manager.getPackageInfo(“com.huawei.android.launcher“, 0); if(info.versionCode=63029) isSupportedBade = true; catch (Exception e) e.printStackTrace(); 注： 此方法为可选操作，非必需操作 。 2. 调用角标接口显示角标： Bundle extr
6、a =new Bundle(); extra.putString(“package“, “xxxxxx“); extra.putString(“class“, “yyyyyyy“); extra.putInt(“badgenumber“, i); context.getContentResolver().call(Uri.parse( “content:/com.huawei.android.launcher.settings/badge/“), “change_launcher_badge“, null, extra); 关键参数说明【红色部分为填充参数】 package:应用包名 clas
7、s:桌面图标对应的应用入口 Activity类 badgenumber:角标数字 (必须为大于或等于 0的数字 ，为 0时不显示角标 )。 注：此方法 桌面有可能会抛出异常 ,建议加上 try catch(Exception e)避免应用程序崩溃。 2.2 申请华为证书 1. 华为 桌面角标 的 使用 ，是基于华为证书的授权，需要开发者 首先要 进行华为证书申请。 开发证书的申请之前，需与华为商务或市场部门签署 API 授权证书使用协议 。网页地址： http:/ 版权所有 华为技术有限公司 第 7 页 , 共 10 页 在使用 华为桌面角标功能 之前，开发者需要到 华为开发者联盟去申请华为证
8、书。 2. 开发者需要先按照下图，创建移动应用。 3. 在创建移动应用后， 点击“ ” ，为此开发者应用创建权签平台申请。 版权所有 华为技术有限公司 第 8 页 , 共 10 页 4. 点击“下一步”， 开放 API 授权申请列表表格 参 照如下方式填写： 5. 按照提示要求，申请权签平台的华为证书，当申请审核通过后， 点击刚才的 权签平台按钮 ，这时会有下载链接，开发者点击此链接下载开发者证书。 版权所有 华为技术有限公司 第 9 页 , 共 10 页 下面截图是一个已经申请成功的开发证书： 2.3 将华为证书打包到开发者 应用 中 使用上面提到 的“ DevPack.exe” 工具，将刚
9、刚下载的华为证书打包到开发者 APK 中： 点击“ OK”后， 会提示保存 “ *_update.apk” ，证书在“ META-INF” 目录下 。 2.4 注意事项 华为证书目前分为两类：开发证书和商用证书。 开发证书是专门为开发者提供的，是一种调试适配阶段的证书， DeviceIds 字段会被严格限制在一定数量设备上， ApkHash 字段不做限制。而商用证书，是作为开发者应用使用开发证书，功能调试完成之后， 处于正式商用阶段的证书。 一般 DeviceIds 字段不会做出限制， ApkHash 字段可选。 注意： 开发者在使用开发证书， 调试完成之后，一定要申请商用证书，才能正式发布。
10、 3 FAQ 1. 如果 华为 开发者联盟网站 的界面， 与本文档中界面不一致，是什么原因？ 版权所有 华为技术有限公司 第 10 页 , 共 10 页 答：这可能因为 华为开发 者 联盟 界面有过更新，请以开发者联盟实际为准。 2. 如何获取 设备的 IMEI 号 和 WIFI MAC 地址 ？ 答 ： IMEI 号 可以在 设置中 查询， 在“ 设置 ” -“关于 手机 ”-“IMEI”查看 ； WIFI MAC 地址 可以在 “设置 ”-“WLAN”-“菜单 ”-“高级 设置 ”-“MAC地址 ”查看 ； 3. 如果 手机 无 IMEI 号 ，如何申请开发证书？ 答 ： 由于 某些 电信
11、 制式的手机，可能无 IMEI 号 ， 此时 建议开发 者 可以使用 WIFI MAC 地址 。 4. 证书 申请周期一般有多长时间？ 答 ： 开发 证书一般审核 时间 为 23 天 ，商用证书一般为 12 周。 5. 在调用角标接口前是否一定要事先获取桌面是否支持角标功能 ？ 答 ： 此功能为可选项，非必需操作。 当 桌面不支持角标功能时，接口会抛出异常， 应用 可以在调用接口的地方加上 try catch(Exception e) 语句以免程序崩溃。 6. 在申请华为证书时如果出现“权签平台” 功能 不能选中点击，是什么问题？ 答 ： 没有 与华为商务或市场部门签署 API 授权证书使用协议 .
