API CLOUD 九次方微信分享

Posted on Edited on In

目录：

1，何为Hybrid App
2, APICLOUD控制台简介
3，开发工具
4，APICLOUD提供的前端开发框架，端API介绍及相应的代码举例

何为Hybrid App

首先介绍下Hybrid App
讲述Hybrid App，要先了解Native App和Web App的定义。Native App是指针对不同的手机操作系统要采用不同的语言和框架进行开发，例如Java(Android), Objective-C(iOS)等；Web App即是 HTML5 APP 框架开发模式，使用HTML5,CSS3以及JavaScript以及服务器端语言来完成开发，WebApp具有跨平台的优势。根据定义显而易见得出两种开发模式的优劣势，Native App可以利用系统的所有特性，因此做出杰出的性能，然而每次功能升级都必须重新打包、审核再上架，平均浪费近两周的时间。而反观Web App就没有这样的问题，其缺点在于Web语言无法访问很多系统特性，性能不高。

鉴于二者各有的优劣势，顺理成章的衍生出了介于中间的开发模式Hybrid。其特点是在原生应用中嵌入一个浏览器组件，然后通过某种方式，让原生代码和网页能够双向通讯，结果就是可以在需要原生功能的时候使用原生功能，而适合放在网页端的部分就放在服务器上。某种程度上利用到了两者的优势。另一个优势就是，由于网页技术在 iOS 和 Android 上是一样的，所以网页的这部分也就天然可以跨平台了。

我今天和大家分享的APPCLOUD就是一套Hybrid APP开发的平台，使用APICLOUD开发的APP 和 原生开发的APP 区别很小，这是因为除了使用HTML CSS JS这些WEB开发技术外，APICLOUD为我们提供了很多原生的模块，供我们在APP中调用，这种原生+WEB的混合模式降低了开发成本，开发门槛，并且可以满足用户的需要。

APICLOUD控制台简介

好了，基本概念到此为止，我们可以直接访问APICLOUD的主页http://www.apicloud.com/,我们要开发一款APP应用，首先要先注册一个账号，然后进入开发控制台，在里面创建我们的应用，----（如图）-----
这里面的东西很多，今天主要和大家介绍下端开发这部分的内容。

端开发，分为以下几部分：
端设置：设置一些APP的图标和启动页面
证书：上传安卓和IOS证书的地方，其中安卓证书可以直接创建，IOS证书需要使用苹果的开发者账号创建，然后上传
代码：提供一些代码更新的日志，其中的代码分支信息是 SVN云端地址，我们可以方便的使用小乌龟等SVN工具随时随地进行代码更新上传
模块：提供官方或者第三方开发者开发的模块，可以将其在我们的HTML代码中进行调用
云编译： 将我们的代码进行云端打包 ，生成多个平台的正式版或测试版的安装包，也可以进行一些加密，压缩的操作，编译完成后就可以把APP上传到相应的应用市场

大家可以看到，端开发这些个内容，其实就是我们开发APP的一套流程，就是把我们的前端代码编译成可以同时安装在IOS和安卓平台上的安装包。

开发工具

工欲善其事必先利其器，使用APICLOUD，那么我们的开发工具应该选用什么呢？
目前我们前端开发主流工具 sublime webstrom 这些APICLOUD都有插件支持，这里建议大家使用他推荐的开发工具APICloud Studio，可以无须再安装插件并且可以在IDE中直接更新，提交代码，更加方便的进行开发调试。我本人是使用sublime通过PackageControl安装的插件，我以sublime举例，按照教程安装好插件后,我们可以新建一个APICOUD项目，项目的结构如图所示—-（如图）—–，我们前端在要按照他提供的目录结构进行开发，

大家看他的根目录下有一个config.xml文件，它的作用是配置一些APP的默认行为和运行参数，
比如 是否全屏显示

是否开启调试模式

状态栏和页面是否重合（沉浸式效果）等等

简略说了下配置文件，我们回到开发工具上，
右键项目根目录 就会有如下菜单：—-（如图）—– ，其中我们最常用的是WIFI真机同步， IOS/安卓真机同步，我们在本地开发的过程中可以随时使用手机调试代码， 比如使用IOS/安卓真机同步，我们要做的就是把USB线连接手机和电脑（手机要开启USB调试权限），然后在项目上点击IOS/安卓真机同步，他会自动打包到手机上，我们就可以看到效果了。
如果大家觉得用手机不方便，也可以在电脑上下载安卓模拟器来进行调试。这个看下教程简单操作下就行了，我就不在这里说了。

APICLOUD提供的前端开发框架，端API介绍及相应的代码举例

下面给大家举例一些代码

首先 APICLOUD自己提供一套前端框架API —-（如图）—–

一眼看去，前端同学可能会觉得很熟悉，这怎么和JQUERY那么像嘛，其实这个东西的作用确实类似于JQ,我们在开发移动应用的时候，引入JQ这种文件比较大的库可能会对运行效率，性能有些影响，所以它就为我们封装好了一些常用的DOM操作,工具函数(string ,Format)还封装了一些比如localStroge这些方法，AJAX方法。这个文件的源代码位于script/api.js下，通过阅读源码，我们可以清晰的看到，他创建了一个空对象u，并把所有创建的方法挂到这个对象u上，最后window.$api = u; 这样命名空间为 $api ，所有方法可如此调用，比如：
$api.addCls(el, ‘newclass’); el是你要绑定的DOM元素，对比 JQUERY 方法 $(dom).addClass(‘newclass’);
再比如事件绑定方法
$api.addEvt(element, ‘click’, function(){
//do something
});
这些其实JQ十分类似，这就为我们在开发APICLOUD应用时候操作DOM，处理事件提供了除了原生JS，JQ/zepto等库外的一种选择。

接下来，我们来看看端API部分的API对象，那么这是个什么东西？我们看看官方文档上的概述：
api 对象是您入门 APICloud 必须了解和熟练掌握的一个基础对象。api 对象提供了构建应用程序所需要的一些基本的方法[Method]，如窗口操作、相册和网络数据访问等；以及一些常见的属性[Attrbute]，如屏幕宽度（screenWidth），系统类型（systemType）等；还有一些常用事件[Event]，如电量低（batterylow）事件、应用进入后台（pause）事件。api 对象不需要 require 引用，可以直接在 js 中使用。

这个描述还是挺清楚的，我就不用过多解释了，提醒大家注意两点 ，
1，端API对象调用方法如：var appId = api.appId;和刚才介绍过的前端框架使用$api有所区别
2，端API对象调用时候要写在 apiready = function() {}中，这个的作用是为了等待端api初始化成功再执行的方法。

下面给大家介绍下我们常用的内置端API对象

APICLOUD为我们提供了很多内置对象
比如一个用的最多的打开新窗口的操作

1
2
3
4
5
6
7
api.openWin({
           name: 'page1',
           url: './page1.html',
           pageParam: {
             name: 'test'
           }
   });

以上代码调用了 端API中封装好的方法，name指这个窗口的名字。url就是页面地址，可以为本地文件路径，也可以为远程地址，pageParam是页面传参，新页面中可以通过 api.pageParam.xxx 获取

再比如说一个下拉刷新

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
api.setRefreshHeaderInfo({
              visible: true,
              loadingImg: '../image/refresh.png',
              bgColor: '#f4f4f4',
              textColor: '#666',
              textDown: '下拉刷新',
              textUp: '松开刷新',
              showTime: false

          }, function(ret, err) {
              //查询数据库
      	//判断是否有新数据
              //更新新数据

             api.refreshHeaderLoadDone();
          });

上面那些属性大家一看就懂，我们要做的就是在回掉函数中加入我们的代码。

那么如果我们要调用非内置的功能怎么办呢，比如我要调用个类似于原生功能的日历

首先，我们还是进入控制台，点击左侧的模块，选择模块库—-（如图）—– ， 大家可以看到 里面有很多官方或者个人提供的模块，我们选定好要用到的模块将其添加至项目，
然后在代码中调用

1
2
3
4
5
6
7
8
9
10
var calendar = api.require('calendar');
calendar.open({
    x: 100,
    y: 100,
    width: 300,
    height: 300,
    specialDate: ['2014-05-01', '2014-05-11', '2014-05-20', '2014-05-25', '2014-05-31']
}, function(ret, err) {
    var date = ret.date;
});

大家可以看到 通过简单的require加载，open调用就可以使用了。如果团队中有IOS或者安卓原生开发者，在现有模块无法满足业务需要的时候， 也可以自己开发并上传模块，这个是可以交易变现的。
，

最后再说下 打包上传，项目开发一段落后我们要上传代码，这时候我们可以在项目上右键 压缩widget包 或本地打包 提交到APICLOUD云端 ，再经过编译成正
式包（widget包是zip包，本地打包是打包成APK文件） , 通过控制台 云修复功能可以上传ZIP包， 我们再打开应用的时候就会有提示更新了，非常的方便。

兼容性

通过APICloud开发的应用，ios平台最低支持至ios5.0版本，Android平台最低支持至Android2.3.0版本

安全性

在客户端代码保密方面，APICloud端有一套“运行时解密”机制，在云编译阶段，将开发者的代码进行加密，同时只有在应用运行时才解密代码，整个过程在内存中进行，应用退出即消失，不会留下解密缓存而导致代码泄露。

数据传输安全方面，APICloud支持https标准请求，支持自定义https证书。考虑到https传输效率较低，APICloud提供端到云的数据加/解密整体解决方案，在http级别下传输加密数据。

对比其他开发平台 APPCAN cordova dcloud

http://blog.csdn.net/kenkao/article/details/50678269