荣耀开发者服务平台(HONOR Developers)是荣耀面向开发者的统一生态入口,通过聚合周边内外部系统,分全球多站点部署,为全球开发者提供业务全生命周期的商业支撑服务。
平台可为软硬件合作伙伴带来三大应用场景服务,包括主动服务的场景化体验智慧服务,智能协同的跨设备互联的智慧生态以及应用与游戏出海服务。同时,荣耀帐号服务、推送服务、运动健康等开放能力和业务也提供了多样化的合作选择。
当前荣耀智慧服务百亿级曝光扶持计划正火热进行中~
一、接入流程
荣耀智慧服务为开发者提供一站式接入服务能力,和全场景、多终端、多入口的AI分发能力,为开发者提高业务推广效率,同时给用户提供便捷、贴心、智能的服务体验。
目前包含四种接入类型:快捷服务、快应用卡片、安卓应用卡片、内容接口卡片,呈现显示包括卡片和图标等,本文将提供安卓卡片(widget卡片)接入指南。
二、开发指南
1. 前言
本文用于指导开发者如何在荣耀手机上开发应用微件,为了让用户获取最佳应用微件的体验,同时为了让荣耀向用户更好地推荐您的应用微件,您需要遵守本文第二章节所描述的技术规范。
访问荣耀智慧服务平台了解更多:Developer (hihonor.com)
2. 技术规范
2.1 遵循Google原生widget开发规范
请参考构建应用微件 | Android 开发者 | Android Developers
2.2 在清单中添加应用微件meta-data信息
为了让我们识别您已经开发完成的应用微件,需要在应用的 AndroidManifest.xml文件中对针对您已声明的 AppWidgetProvider 类,新增meta-data信息com.hihonor.widget.type ,代码示例如下:
<receiver android:name="ExampleAppWidgetProvider" ><intent-filter><action android:name="android.appwidget.action.APPWIDGET_UPDATE" /></intent-filter><meta-data android:name="android.appwidget.provider"android:resource="@xml/example_appwidget_info" /><meta-data android:name="com.hihonor.widget.type"android:value="honorcard" />
</receiver>
对于上述代码示例中两组meta-data信息说明如下:
2.2.1 第一组meta-data信息为android原生配置,若需配置仅荣耀设备读取,其他厂商设备不读取卡片信息,可将“android.appwidget.provider”更换为"android.appwidget.honor.provider".
2.2.2 第二组meta-data信息,是为了让荣耀识别您已经开发完成的应用微件,并在荣耀快服务中心等新入口展示卡片。此配置不影响荣耀MagicUI6.0以下的旧版本手机、其他厂商机型手机上卡片的展示。
2.3 集成YOYO建议SDK(可选)
如果您需要使用我们的智慧能力为您推荐您的应用微件,您需要接入YOYO建议SDK,接入方法请与荣耀运营人员了解。
2.4 接收并处理YOYO建议定向广播信息(可选)
如果您的应用微件信息已经在荣耀HISP平台注册,那么YOYO建议会根据智慧场景向您推送定向广播,您可以在您的应用微件收到广播后做相应的动作,例如改变应用微件的显示内容。
定向广播接收处理代码示例如下(JAVA):
public class MyAppWidgetProvider extends AppWidgetProvider {@Overridepublic void onUpdate(Context context, AppWidgetManager appWidgetManager, int[] appWidgetIds) {for (int appWidgetId : appWidgetIds) {Bundle appWidgetOptions = appWidgetManager.getAppWidgetOptions(appWidgetId);if (appWidgetOptions != null) {String host = appWidgetOptions.getString("host", "");if ("HonorYOYO".equals(host)) {// 来自于荣耀YOYO的消息String scene = appWidgetOptions.getString("scene", "");String service = appWidgetOptions.getString("business", "");}}}}
}
广播消息中附加场景信息在intent extras中,内容如下:
字段名 | 类型 | 说明 |
host | String | 固定值HonorYOYO 通过该值来区分是否来自于荣耀YOYO的信息 |
scene | String | 场景信息, 枚举值 MusicRoco-音乐推荐, TakingTaxi-打车, NewsReco-新闻推荐 |
business | String | 业务意图信息, 枚举值 Music-音乐, Taxi-出租车, News-新闻资讯 |
2.5 卡片中的本地图片设置圆角
在制作卡片时,在使用本地图片填充widget布局中的imageView时,当imageView拥有固定宽高时,示例代码如下(kotlin),仅供参考。
val remoteViews : RemoteViews = .....
val roundedBitmapDrawable = RoundedBitmapDrawableFactory.create(context.resources,BitmapFactory.decodeResource(context.resources, 本地图片资源ID)
)
roundedBitmapDrawable.isCircular = true
val bitmap = Bitmap.createBitmap(roundedBitmapDrawable.intrinsicWidth,roundedBitmapDrawable.intrinsicHeight, Bitmap.Config.ARGB_8888
)
val canvas = Canvas(bitmap)
roundedBitmapDrawable.setBounds(0, 0, canvas.width, canvas.height)
roundedBitmapDrawable.draw(canvas)remoteViews.setImageViewBitmap(布局中的imageView资源ID,bitmap)
当imageView未设置固定宽高,可采用给图片覆盖一个带有圆角的边框的方式来裁切圆角,示例代码如WidgetCardDemo的round_x_stroke_x_foreground.xml文件。
当边框的宽度设置为xdp时,对应的imageView也需设置padding = “xdp”
2.6 荣耀卡片适配PAD及折叠屏
卡片适配基本原则:
均分:保证指定元素与元素之间的间距一致,去适应卡片容器的尺⼨变化;允许定义组件最左端和最右端是否一起均分/指定固定值,若不定义,默认一起参与均分;
左右结构:左侧距离左边固定或左侧水平居中,右侧距离右边固定或右侧水平居中,保证卡片拉伸后显示效果无误。
左右结构、均分:可以往水平/垂直方向拉伸,来适应卡片大小的变化
占比:定义了占比能力的组件,保证指定元素始终在卡片内的某一个比例空间中进行布局。⽔平方向或垂直方向有占比能力,也可均有
拉伸:在布局宽度变化的时候,列表会随宽度变化⽽体现拉伸能力
宫格样式:卡片在pad下,可显示更多的元素。例:手机竖屏,图片可展示3个,相同卡片pad上可展示4个;
缩放:沉浸式背景图可以往⽔平/垂直⽅向拉伸,来适应组件容器的变化,进行自适应撑满容器,不得出现图片拉伸比例等情况。图文列表的图片比例不变,文字根据宽度拉伸
按照荣耀公司卡片适配UX规范,卡片分为纯文本类、图文类、列表类、宫格类。
为了在PAD展示情况下有更好的用户体验效果,所有类型卡片建议至少要实现横向拉伸,宽度通过权重方式设置。
2.7 widget卡片点击跳转指定页面实现
卡片跳转指定页面通过PendingIntent实现,具体实现方式如下(kotlin):
val intent = Intent()intent.setClass(context, Test::class.java)
intent.addFlags(Intent.FLAG_ACTIVITY_CLEAR_TASK)
intent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK)
val pi = PendingIntent.getActivity(context, requestCode, intent,PendingIntent.FLAG_IMMUTABLE)
remoteView.setOnClickPendingIntent(layoutId, pi)
提示:
Test:是需要跳转的页面或路由页面;
layoutId:点击的控件id;
若不同卡片需要跳转不同activity,需设置不同的requestCode。
2.8 深色模式适配
深色模式适配按照原生系统适配方式,在values和values-night分别配置通用模式和深色模式下使用的颜色,在drawable和drawable-night下分别配置通用模式和深色模式使用的资源文件。
2.9 卡片圆角处理
荣耀的widget卡片容器已做圆角处理,大小是16dp,卡片提供方外层四周圆角不用单独设置,卡片内部元素使用圆角还需自行设置。
2.10 折叠屏手机折叠和展开态卡片适配
在安卓S版本关于widget应用小部件新增了响应式布局方案,根据当前widget展示的大小,显示指定的样式具体实现如下(kotlin):
override fun onUpdate(context: Context?, appWidgetManager: AppWidgetManager?, appWidgetIds: IntArray) {for (appWidgetId in appWidgetIds) {val normalView = RemoteViews(context.packageName, R.layout.normal4*2)val unfoldViewForBoard = RemoteViews(context.packageName, R.layout.unfold4*2)val unfoldViewHorOneForLauncher = RemoteViews(context.packageName, R.layout.unfold4*2)val unfoldViewHorTwoForLauncher = RemoteViews(context.packageName, R.layout.unfold4*2)val unfoldViewVertForLauncher = RemoteViews(context.packageName, R.layout.unfold4*2)val viewMapping: Map<SizeF, RemoteViews?> = mapOf (SizeF(320f,152f) to normalView, //正常4*2样式SizeF(460f,142f) to unfoldViewForBoard, //负一屏展开4*2样式SizeF(561f,136f) to unfoldViewHorOneForLauncher, //桌面横屏展开4*2样式1SizeF(531f,136f) to unfoldViewHorTwoForLauncher, //桌面横屏展开4*2样式2SizeF(529f,164f) to unfoldViewForLauncher //桌面竖屏展开4*2样式)val remoteViews = RemoteViews(viewMapping)AppWidgetManager.getInstance(context).updateAppWidget(appWidgetId, remoteViews)}
}
注意:
该方案仅针对Android 12及以上版本有效, 即要求compileSdkVersion = 31
安卓官网地址:https://developer.android.com/guide/topics/appwidgets/layouts
2.11 大字体大显示
为保证所有三方卡片的整体效果一致,建议文字统一使用dp为单位,来禁止文字字体跟随系统设置变化,例如:android:textSize="14dp"