AppCan WidgetOne SDK 接入文档(Android)

添加依赖

添加依赖可以通过aar直接集成或者通过服务器导出的WidgetOne SDK集成

引擎通过aar集成

  1. 将Engine-system-release-4.0.0.aar拷入libs目录，下载地址

  2. 在Application moudle build.gradle中加入如下配置：

    1. repositories {
    2.     flatDir {
    3.         dirs 'libs'
    4.     }
    5. }
    7. dependencies {
    8.     compile(name: 'engine-4.0.0-systemRelease', ext: 'aar')
    9. }

通过服务器导出WidgetOne SDK

如果服务器支持直接导出WidgetOne SDK，为了后续维护方便，建议新建一个library工程。

然后把对应的libs，res，assets，AndroidManifest.xml拷贝到对应的目录即可。

最后把该library工程作为原工程的依赖即可。

相关工程配置

AndroidManifest.xml

aar可以直接用解压文件打开修改然后保存

Application 节点

  2.       android:name="org.zywx.wbpalmstar.widgetone.WidgetOneApplication"
  3.         android:allowBackup="false"
  4.         android:allowClearUserData="false"
  5.         android:debuggable="false"
  6.         android:icon="@drawable/icon"
  7.         android:label="@string/app_name"

如果有自己的Application，此段可以去掉。硬件加速开关可以根据情况进行更改

LoadingActivity 节点

  1. <category android:name="android.intent.category.LAUNCHER" />

删掉此行，不然桌面会有两个应用图标

libs文件夹

如果原来工程中已经有了相应的jar，则删掉libs中对应的jar，如常见的android-support-v4.jar

build.gradle

targetSDkVersion需要设置为17以下

代码添加

  1. 初始化AppCan引擎

    初始化尽量在Application.create() 中进行，否则某些插件可能无法正常运行。

    原因：某些多进程的第三方sdk，需要在其他进程初始化，Application.onCreate()会执行多次。如网易云信。

    同步初始化：

    1. AppCan.getInstance().initSync(this);

    异步初始化：

    1. AppCan.getInstance().init(this, new OnAppCanInitListener() {
    2.             @Override
    3.             public void onInit() {
    5.             }
    7.             @Override
    8.             public void onError() {
    10.             }
    11. });

    ​

  2. 打开页面

    1. AppCan.getInstance().start(MainActivity.this,null);

    需要自定义起始页可以调用：

    1. AppCan.getInstance().start(Activity activity,String indexUrl,Bundle bundle)

    bundle为需要传给起始网页的参数，可以在网页中通过uexWidget.onLoadByOtherApp()监听获取到

源码调试

调试引擎源码：

引擎源码地址：https://github.com/AppCanOpenSource/appcan-android

1. 删除引擎jar

aar文件需要删除classes.jar

library工程需要删除libs目录下的AppCanEngine-system(内核)-x.x.x(版本).jar

2. 添加引擎jar的对应版本源码

clone对应版本引擎jar 的源码

拷贝源码的appcan-android/Engine/src/main/java下的全部文件合并至library工程的src目录下或者src/main/java(视情况而定，工程的source目录)

拷贝源码的appcan-android/Engine/src/system(内核)/java下的全部文件合并至library工程的src目录下或者src/main/java(视情况而定，工程的source目录)

引擎有三种内核，crosswalk,x5,system，对应于gradle的flavor

调试插件源码：

1. 删除插件jar

删除libs目录下的plugin_uexXXX(插件名).jar

2. 添加插件源码

插件源码地址：https://github.com/android-plugin

下载插件对应版本的源码，将src目录拷贝合并到library工程的src目录

插件版本可以通过assets/info.xml文件查看

其他

监听返回事件

可以调用如下方法监听返回事件

  1. AppCan.getInstance().registerFinishCallback(new OnAppCanFinishListener() {
  3.      @Override
  4.      public void onFinish(int i, String s) {
  6.      }
  8. });