·使用手册

下面将为您介绍AppCan 官方插件API如何调用主要的使用方法.

温馨提示： 每个API的“简介>开源源码”部分，官方的公共插件“已集成到打包平台，无需下载自定义上传，直接勾选使用”原生代码已经开源，如果官方插件无法满足您的定制需求，特定API接口可自定义配置参数，当然也可以进行二次开发封装，了解开源文档。

window.uexOnload 窗口加载完毕后平台将触发此方法。AppCan新版JSSDK支持appcan.ready替换window.uexOnload；公共插件:为AppCan开放出的稳定版插件（已集成到平台公共插件，直接勾选使用），持续维护更新；自定义beta版插件：官方开放的公测插件收集用户使用反馈（自定义上传到我的插件勾选使用），持续维护更新。

了解观看视频，0基础学习AppCan平台APP开发？全程指导开启快速学习之旅。在线打包失败了，求助？

·使用手册 - 图1AppCan项目创建　·使用手册 - 图2微信插件使用 　　

首先需要初始化一个AppCan javascript sdk，API对象的操作都是通过JSSDK完成的。 了解JSSDK

appcan_JSSDK窗口管理应用管理网络事件 Events与设备Device数据存储
概要窗口模块Windowwidget网络请求Request事件模块EventEmitterDatabase
基础类库Base浮动窗口模块FramewidgetOne离线缓存icache设备模块DeviceLocStorage
UI组件…文件模块File

1、如何调用API接口

代码结构

AppCan在IDE编写代码时， AppCan平台采用html+css+js 结构调用。

ide在项目开发时默认会创建基本的框架结构 css、js文件夹、config.xml、index.html、index_content.html（即空模板项目）css目录下的css文件里是ui基础框架基础类文件，js目录下是AppCan封装提供的jssdk文件，其中appcan.control.js、appcan.js是appcan整个框架依赖的基础库，不能去除，同时也封装了uexWindow、 uexWidget、uexWidgetOne基础方法，比如appcan.window.xxx appcan.frame.xxx使用必须要依赖这俩个库。

使用JSSDK调用 API

下面jssdk封装的appcan.window与调用原生接口一致，uexWindow.open这种方式不推荐采用，大可采用以下方式

  1.    appcan.window.open({
  2.                  name:name,
  3.                  dataType:0,
  4.                  aniId:2,
  5.                  data:name + ".html",
  6.                  extraInfo:{
  7.                      opaque:true,
  8.                      bgColor:bg
  9.                  }
  10.             });

使用AppCan原生接口调用 API

JS SDK对常用底层插件API的接口再次封装，没有封装的插件API需要采用直接调用方式如照相机(uexCamera.)、图片浏览(uexImage.)、邮件(uexEmail.)等各分类插件API 。

例如

js代码

  1. < script type="text/javascript">
  2. function createButton(){
  3.         var id = 1001;
  4.         var x = 100;
  5.         var y = 100;
  6.         var width = 100;
  7.         var height = 100;
  8.         var jsonData = '{"title":"AppCan","titleColor":"#111111","bgImage":"res://a1.png","textSize":"18"}';
  9.         uexButton.open(id,x,y,width,height,jsonData);
  10.     }
  11.     function closeButton(){
  12.     var id = 1001;
  13.     uexButton.close(id);
  14. }
  15. </script>

html页面body里：

  1.    < input class="btn" type="button" value="uexButton" onclick="createButton();"/>
  2.    < input class="btn" type="button" value="close" onclick="closeButton();"/>

AppCan javascript sdk与插件API一一对应，灵活性高且易于扩展。您可以基于AppCan javascript sdk对AppCan原生插件的API进行封装，扩展出自己想要的功能。

2、插件API接口

API接口方法对于一些方法还封装了一些回调方法，也是对于该方法进行的回调，按照正常接口调用即可

例如

  1.  < script type="text/javascript">
  2.  var param1 = {
  3.         appData:'com.tencent.mobileqq'//判断手机上是否安装qq应用
  4.     };
  5.     var data1 = JSON.stringify(param1);
  6.     uexWidget.isAppInstalled(data1);
  8.  uexWidget.cbIsAppInstalled = function(info){
  9.         var result = JSON.parse(info);
  10.         if(result.installed == 0){
  11.             alert('installed');
  12.         }else{
  13.             alert('not installed');
  14.         }
  15.     }
  16.     </script>

如果您完成以上代码编辑，恭喜您，您已经拥有了具备调用API的基础。

最后一步配合插件查看API接口效果，需要勾选已调用的api插件打包，下载apk/ipa安装调试。

3、接口参数说明

对于某些特殊接口，是有对应的参数要传入

例如

 function shareWebImgTextToQQ(){
            var  appId = "222222"
            var json = '{"title":"图文分享标题","summary":"图文分享消息摘要","targetUrl":"http://appcan.cn","imageUrl":"res://aa.jpg","appName":"uexQQ", "cflag":"1"}';
            uexQQ.shareWebImgTextToQQ(appId, json);
            }

参数值输入的要求

AppCan 插件api接口在调用时, 可能需要传递相应的值给接口. 此时需要您在传值时, 注意下面的事项:

• 大部分情况下, 您会传递一个数字类型的值到AppCan 插件api接口参数中, 此时只需要简单的写上需要的值即可:

数字的话,双引号单引号或直接写都可以

uexWindow.setReportKey(1,1)

•如果您的输入中有空格出现, 那么请使用单引号(')括住您的值

这种情况不常见，可以忽略

•如果是采用一个string 类型请使用双引号(")括住您的值

例如

windName:(String类型) 必选 窗口名称，默认为当前窗口

popName:(String类型) 必选 浮动窗口名称

inPageName:(String类型) 必选 单页面窗口的名字

js:(String类型) 必选 js脚本内容

uexWindow.evaluateMultiPopoverScript("", "multipop", "pop2", "alert('multipop')");

• 使用JSON格式作为参数

JSON格式在AppCan 插件api中是允许使用的, 特别是当您要同时传入多个字段时, 可以按照JsonArray的格式传入多个id值. Json格式需要您严格按照Json格式编写数据, 并且要对Json格式中的双引号(")进行特殊的处理

例如

    var params = { 
leftSliding:{
        width:240,
        url:"uexWindow_left.html"
    },
    rightSliding:{
        width:240,
        url:"uexWindow_left.html"
    } 
 }; 
 var paramStr = JSON.stringify(params);
 uexWindow.setSlidingWindow(paramStr);

var id = 1001;
        var x = 100;
        var y = 100;
        var width = 100;
        var height = 100;
        var jsonData = '{"title":"AppCan","titleColor":"#111111","bgImage":"res://a1.png","textSize":"18"}';
        uexButton.open(id,x,y,width,height,jsonData);

4、如何调试插件效果

AppCan封装的插件是在原生打包环境进行编译的，仅在AppCan平台上使用，都需要勾选插件名称打包，生成安装包 需要真机调试效果。

·使用手册 - 图3

以上信息是否解决您的问题？是否

免费注册，快速体验