使用APICloud平台,可以使用前端技术快速开发iOS、Android App、小程序、Web等多端应用。在开发过程中,调用模块可以极大的提升开发效率。本文分为三个部分,告诉大家如何使用APICloud 的原生模块、H5模块以及多端组件,快速实现功能开发。
一、原生模块使用教程
原生模块是指使用 Android 和 iOS原生开发语言封装的功能模块。封装好的模块可以使用js调用。
1、添加模块
进入 APICloud 控制台(www.apicloud.com/console),找到模块库,搜索要使用的模块。
点击”+“进行添加
2、编译自定义loader ,并下载安装到手机
自定义loader是Android或iOS安装包,也是我们进行开发调试的运行环境。代码修改后,使用开发工具 Studio 3 的 wifi 同步功能,把代码同步到自定义loader中,可以查看修改代码的运行效果。 如下图,点击自定义loader 导航, 点击【编译android 自定义loader】按钮或 【编译iOS自定义loader】按钮,进行编译。编译完成后,使用手机扫描二维码,下载安装到手机。
3、根据模块文档,编写调用模块的代码。 使用模块前一定要仔细阅读模块文档,尤其是支持平台,是否Android、iOS都支持,不要写完代码才发现只支持某一平台,做无用功。某些模块封装第三方平台的SDK, 如极光推送模块,在使用这类模块时,不仅要阅读模块文档,还要阅读极光官方的文档。
以UIButton 模块为例:https://docs.apicloud.com/Client-API/UI-Layout/UIButton
打开编辑器,在页面编写代码,以调用UIButton模块的open 接口为例:
如何使用 Studio 3 编辑器检出项目,新建项目,提交或更新代码,本文不做介绍,可参考以下Studio 3文档进行学习。
https://docs.apicloud.com/apicloud3/#/overview/devtools?index=0&subIndex=3
4、使用 Studio 3 wifi 同步功能,将代码同步到自定义loader 查看代码运行效果。
如下图,点击真机同步快捷键 , 点击 【通过wi-fi 连接新的设备】, 弹出二维码和ip地址、端口号。
打开手机上的自定义loader,点击浅灰色圆圈,弹出如下界面,点击扫一扫,可以扫描上图的二维码,自动连接。或者手动输入ip 地址和端口号,然后点连接。连接成功后,灰色圆圈变绿色。
在开发工具项目根目录上右键 - 选择 WiFi 同步全量 命令,就可以把代码同步到自定义loader。( 注意手机上自定义loader 要处于打开状态,不能退到后台。)
运行效果如下图:可以看到按钮模块的效果已经显示在页面上。
其他注意事项:
(1)如果使用需要在config.xml 中配置appkey , 或res 目录下需要配置文件。这两种情形,要配置代码后,先提交代码,再编译自定义loader,这样这些配置项才能生效。
(2)open 接口的fixedOn 参数指定模块所在页面的name,如果传错误,会造成模块不显示。
二、H5模块使用教程
H5模块是指使用HTML、CSS、JS语言开发的模块。所以这类模块需要下载模块源码,在页面中引用。
将下载后的代码包解压:
将 libs 目录下的base.js 复制到项目script 目录下,并在页面中引入,如下图:
三、多端组件使用教程
多端组件是指使用 avm.js 开发的组件,通常同时适配Android、iOS、小程序、H5 , 具体支持情况还要看每个组件的说明文档。
同样需要组件下载源码,复制到项目中,在页面引入依赖的组件。注意多端开发模式,使用的是stml 页面,语法类似vue 。在openFrame 或 openWin 时 avm 参数传true,可以打开stml 页面。
将a-button.stml 页面复制到项目的components目录,因为a-button.stml 又依赖a-icon.stml index.js Toast.js , 所以将这些文件也放到components目录。通过阅读readme.md 文档,可以查查看a-button.stml 的使用介绍。如下图,通过在 view 标签中 添加 a-button 标签,在 script 标签中通过 import 语法引入组件。
WiFi 同步到自定义loader 运行效果如下:
如果使用ACT组件,推荐从Github或Gitee下载。
Github 地址:https://github.com/apicloudcom/act
Gitee 地址 :https://gitee.com/apicloud/act