移动APP开发

1. 移动APP说明

机智云开发者中心的【智能产品】是用户的硬件在机智云云平台的一种表现形式,而【移动应用】是产品在移动端的使用平台。

【移动应用】分为智能家居、商用租赁、资产跟踪管、设备安防、自定义类型,可根据需求创建相应的移动应用。配置完成应用页面的基础功能及拓展功能,通过配置证书就可以快速构建应用。

*商用租赁、资产跟踪管、设备安防应用功能将逐步开启,敬请期待。

*智能家居类应用是以智家为框架创建的应用APP,企业及用户可以通过修改应用配置创建属于自己的智能家居APP。

2. 创建应用

► 在开发者中心,选择需要创建应用的项目,点击右侧的【创建】按钮并选择【移动应用】;

img

► 默认选择”智能家居”类型应用,填写应用名称和包名,选择应用类型,等待创建完成进入应用详情。

*智能家居使用是公版智家APP的框架,商用租赁使用是租赁 APP的框架,自定义应用是自定义类型的应用。

img

3. 查看/修改应用信息

► 智能家居应用创建完成后,可以进入应用详情中查看或修改编辑应用信息,只支持修改应用名称,包名和APP ID生成后不可修改。

img

App4

4. 个性化配置

个性化与功能中可以配置应用的图标、启动页、主题色和默认壁纸。

4.1 配置APP图标和启动页

► 进入应用详情,上方切换到【个性化】,左侧点击【个性化与功能】,右侧选择【信息】,可设置 APP 图标和启动页图片,鼠标移动到图片时中间可预览显示效果,设置完成后点击【保存】即可。

img

4.2 配置APP主题色

► 进入应用详情,上方切换到【个性化】,左侧点击【个性化与功能】,右侧点击【主题】,可以设置 APP 的主题颜色。点击“选择主题”可以选择主题模板,根据需求设定不同的主题色,设置完成后点击【保存】即可。

img

4.3 配置APP壁纸

► 进入应用详情,上方切换到【个性化】,左侧点击【个性化与功能】,右侧点击【壁纸】,可以设置 APP 默认的壁纸和预设的壁纸,也可以通过点击壁纸选择资源库或上传新的壁纸。,设置完成后点击【保存】即可。

img

5. 关联产品

应用关联产品后,就能在App中的添加设备看到对应的设备品类。

► 进入应用详情,上方切换到【个性化】,左侧点击【个性化与功能】,右侧切换【关联】功能,点击“+”按钮添加关联的产品,设置完成后点击【保存】即可。可关联已创建的产品,也会显示已关联的产品,只有关联了的产品才能显示在 APP 中。

img

6. 页面配置

6.1 配置「关于我们」页面

► 进入应用详情,上方切换到【个性化】,点击左侧【页面设置】展开更多功能,可配置关于我们、隐私条款及用户协议这几个页面的内容,选择【关于我们】,通过点击“+”号新增应用/公司简介等内容,编写完成后点击【保存】即可。

img

6.2 配置「隐私条款」页面

► 进入应用详情,上方切换到【个性化】,点击左侧【页面设置】展开更多功能,选择【隐私政策】,在右侧编辑区域编写隐私条款内容(支持中英文),可通过文档粘贴进来并保留样式,编写完成后点击【保存】即可。

img

6.3 配置「用户协议」页面

► 进入应用详情,上方切换到【个性化】,点击左侧【页面设置】展开更多功能,选择【用户协议】,通过右侧编辑区域编写用户使用协议内容(支持中英文),可通过文档粘贴进来并保留样式,编写完成后点击【保存】即可。

img

7. 拓展功能

点击顶部【拓展功能】按钮,已支持配置的拓展功能有:第三方登录、多语言配置、推送设置、定位配置、体验中心配置、Siri管理、第三方平台。

7.1 配置第三方登录

点击左侧【第三方登录】功能,支持配置QQ、微信、Twitter、Facebook等第三方授权登录。

► 第三方登陆需要启动并配置相关key参数,鼠标移入对应的第三方登录平台,并点击【启动】。

img

► 开启后填写对应的参数,填写完成后点击【保存】即可。

img

需要配置的参数类型

授权类型 参数1 参数2 参数3
QQ appID appKey -
微信 appID secret -
Twitter appID fabriclD secret
Facebook appID - -

7.2 配置国际化多语言

支持全球化部署,配置多地区语言。

► 点击左侧【多语言配置】,应用配置中保存的文案会全部罗列出来,点击“+添加语言”,选择需要配置的语言,点击确定。

img

► 编辑对应文案的对应语言内容,点击右侧可修改内容,编辑点击右上角“保存编辑”按钮。

img

► 已支持28种多语言配置,分别为:

中文简体 zh

中文(繁体)

英语 -English

法语 -Französisch

德语 -Deutsch

意大利语 -Italienisch

阿拉伯语 -العربية

日语 -日文

西班牙语 -Español

保加利亚语 -български

克罗地亚语 -hrvatski

捷克语 -Česky

丹麦语 -Dansk

荷兰语 -Nederlands

希腊语 -Ελληνικά

匈牙利语 -Magyar

印度尼西亚语 -Orang indonesia

哈萨克语 -Қазақша

韩语 -한국어

老挝语 -Laotian

马来语 -Melayu

波兰语 -Polski

葡萄牙语 -Português

罗马尼亚语 -Românesc

瑞典语 -Svenska

泰语 -ไทย

越南语 -Tiếng việt

俄语-Pусский

乌克兰语-Український

7.3 开启推送功能

推送设置:支持极光推送(APP系统推送)、电话推送和短信推送。

*极光推送(JPush):我们使用极光推送作为推送引擎,用于APP云到端的通知功能。即指在手机的通知栏(状态栏)上会显示的通知信息,主要用来达到告知用户设备状态提醒的目的。

► 点击左侧【推送设置】:极光推送需要设置 Appkey。电话和短信推送可直接“点击开启”,开启后可以使用场景等设置电话和短信推送的功能。配置完成之后点击“保存”按钮。

img

7.4 配置定位功能

► 点击左侧【定位配置】:支持高德地图和谷歌地图配置。设置高德地图(国内)和谷歌地图(海外)对应的 Android Key后,点击“保存”按钮。

地图在智家APP中的应用主要有两个方面,一是定位用户当前位置,获取天气信息。二是智能场景中设置电子围栏,实现自动化。

img

7.5 开启体验中心

开启体验中心后,用户可以在APP中模拟设备进行控制体验。

► 点击左侧【体验中心配置】:开启后可在应用中体验已关联产品的设备控制模版。

img

7.6 开启Siri管理

► 点击左侧【Siri 管理】:开启 Siri,iPhone 手机用户可将手动智能场景添加到 Siri。

img

7.7 配置第三方平台说明文档

第三方平台是APP中对应语音平台的开启与关闭,以及用户使用说明文档的配置,产品发布到第三方平台需要在首页创建语音应用后配置指令和发布技能。机智云开发者中心提供第三方平台的OAuth授权能力,已经支持国内外主流的平台,分别是Echo、Google Home、天猫精灵、IFTTT、DuerOS(小度音箱)、米家(小爱音箱)。

► 点击左侧【第三方平台】,在右侧状态中开启/关闭此功能,开启后可以配置 APP 对应的第三方语音平台的名称和授权使用帮助文档,点击“+”号,新增第三方语音平台的授权文档内容。

img

8. 构建应用

通过配置应用证书后,可以快速构建应用,不配置证书只能构建测试应用,不能发布上架于应用市场。

8.1 配置应用证书

► 构建应用需要上传iOS 和安卓的证书和填写证书密码。

iOS证书需要到 Apple 开发者平台获取。不配置证书,只能构建测试版APP

安卓证书可点击“自动生成“,生成安卓的证书。

img

8.2 上传iOS安装包到Testflight

► iOS App Store:通过设置 Team ID,并将机智云开发者账户加入到苹果开发者平台的组织下,然后授权对应的应用,即可自动将构建的 APP 包上传到 Testflight,方便开发者发布应用。

*Testflight:是苹果的官方内测商店,App上架需要先通过Testflight来进行内测,测试没问题后,可以直接申请发布到正式商店Apple Store。

img

8.3 构建应用

► 应用构建:点击构建应用,等待构建 APP 包。构建线上版需要上传正确的证书。

img

8.4 下载安装包

- 测试版构建完成后可以点击“二维码图标“,扫描展开的二维码安装测试包。(但由于使用的是机智云企业证书,会导致部分功能可能不可用)

- 线上版构建完成后可以下载安装包,点击“iOS/安卓图标“即可下载安卓包。

img

9. 创建自定义应用

自定义应用是未定义类型的应用,针对自助开发的用户,生成对应平台的APP ID,可以根据文档指引,下载示例源代码进行二次开发。

9.1 创建应用

► 填写应用名称和包名,应用类型选择“自定义”,选择平台类型,点击确认。

img

9.2 查看/修改应用信息

► 自定义应用左侧显示应用信息,包括:应用图标、应用名称、应用包名、iOS和安卓平台的APP ID、APP Secret。

img

img

9.3 关联产品

► 自定义应用右侧显示的关联产品,点击“+”按钮可以添加产品,已关联的产品会将配置文件打包到源代码中。

img

*下载源代码的功能在逐步开放中,敬请期待。

9.4 下载APP SDK

► 自定义应用中间显示应用开发FAQ、APP SDK下载入口以及帮助文档,帮助引导开发者更好地进行二次开发。

img

©2011-2022; Gizwits IoT Technology Co., Ltd. 粤ICP备11090211号