插件开发入门教程

创建一个android工程

如果你已经熟悉如何创建一个Android应用,可以跳过此节。

要进行浏览器的Android插件开发,首先我们需要在Eclipse中去创建一个Android工程。

  • 创建android应用

  • 填写应用名,选择Android SDK版本(API 8及以上),Next

  • Configure Project,默认即可,Next

  • Configure Launcher Icon,配置应用图标,默认即可,Next

  • Create Activity,这里选择创建的Activity的形式,默认选择是”BlankActivty“,我们可以默认不选择,Finish

  • 创建后,工程的结构图如下所示:

这里是一个标准的Android开发的工程结构图,如果有什么不理解的地方,可以参考Android的在线开发文档

修改 AndroidManifest.xml

在AndroidManifest.xml中,application标签中加入如下内容。这样此插件才能被浏览器识别。

<!-- Declare Addon Service here! -->
<service android:name="com.uc.addon.sdk.remote.AddonService">
    <intent-filter>
        <action android:name="com.uc.browser.action.Addon"/>
    </intent-filter>
</service>

导入SDK Jar包

UCAddonSDK.jar放入libs目录, 刷新工程,结构如下所示:

建立组件类

根据需要,建立组件类。这里我们要完成一个点击后新建一个浏览窗口的插件。这个插件必须继承SDK提供的AbstractExtension类,然后重写onInvoke()函数。onInvoke()在插件被点击后,由浏览器调用。简单的实现如下:

package com.uc.demo;

import com.uc.addon.sdk.remote.AbstractExtension;
import com.uc.addon.sdk.remote.Browser;

public class NewTabDemo extends AbstractExtension{

    @Override
    public void onInvoke() {
        Browser browser = getBrowser();
        browser.tabs.create("http://www.uc.cn", true);
    }

}

提供配置文件

在assets下新建addon文件夹,插件的配置文件必须放在该文件夹下

图片icon.png是插件所对应的图标,addon_config.xml为插件的配置文件。addon_config.xml提供的信息包括:

  1. 插件的基本信息,如插件的名字,图标,版本号

  2. 插件组件的信息,如声明Extension和Event Receiver由哪个类实现,组件的图标和名称等
    (注意:配置文件需要的资源必须放在assets目录下,否则资源不能被正确读取。)
    对于上面的Demo,其配置文件如下:

    <?xml version="1.0" encoding="utf-8"?>
    <addon name="NewTab"
        icon="addon/icon.png"
        versionCode="1"
        minSdkVersion="2.0">       
        <uses-permission name="addon.permission.TAB" />
        <extension name="com.uc.demo.NewTabDemo"
            description="New Tab"
            location="AddonBar"
            icon="addon/icon.png">
        </extension>
    </addon>
    

注意:如果你要打开一个新的Tab,你需要配置Tab权限: 查看更多权限)。

Run It !

现在,我们可将插件安装至手机或模拟器了。然后打开UC浏览器,你会发现插件出现在插件面板上。

后续

如果你需要参考详细的样例,可以下载完整的SDK样例