Android 插件化

自己一切文章制止任何形式的转载

条件

做了一个文件夹办理运用giant-explorer,链接github.com/storyteller…,在完成根底功用之后,希望剩余的功用都经过插件完成。

插件有别于热修正,热修正不希望知道用户感知到进行了热修正,而插件需求用户手动装置或者确认,必要情况下还需求用户同意相关权限和政策。

插件化有三个选择:

  1. 装置后的apk

    与正常的app 没有什么区别,不过咱们可以做一些特殊操作,让用户自动选择运用某个插件翻开,而不是弹出来一个选择器。

  2. 未装置的apk

    解析class 后在当前app 进程实例化。原本的主意是加载一个aar文件,不过aar 文件还不能被class loder 加载,遂抛弃。

  3. 前端插件

    有人会说android 也算是必定的前端了,其实这种问题不太好讨论,Android 也可以开发服务器运用,浏览器也可以执行node.js的代码,所以后边仍是运用第几种插件来进行描述。

正题

  1. 榜首种插件

    在Android 中,不同的app 之间需求进程间通讯,由于原本宿主运用便是一个文件办理运用,所以顺从其美就运用了content provider 作为进程间通讯的办法。

    宿主运用构建一个uri,传递给插件,插件经过contentResolver.openFileDescriptor(u, "r") 获取fileDescriptor (某些代码中会写作fd,这是Linux 中的概念,相当于id),然后咱们经过这个fd 获取文件内容。比方咱们获取图片的fd 然后加载到ImageView 上。

    val fileDescriptor = parcelFileDescriptor?.fileDescriptor ?: return
    val decodeStream = BitmapFactory.decodeFileDescriptor(fileDescriptor)
    findViewById.setImageBitmap(decodeStream)
    

    然后在插件中设置一个Intent Filter,用于宿主运用查找,标明自己可以作为插件运行。

    <intent-filter>
        <action android:name="com.storyteller_f.action.giant_explorer.PLUGIN" />
        <category android:name="android.intent.category.DEFAULT" />
        <data
            android:mimeType="image/*"
            android:scheme="content" />
    </intent-filter>
    <meta-data
        android:name="group"
        android:value="view" />
    <meta-data
        android:name="title"
        android:value="@string/app_name" />
    

    下面的meta-data 你或许会比较古怪,其实他们是用来添加一些额定的信息,由于展示出来的按钮总要有个姓名,所以咱们需求经过这种办法指明,这样乃至也有i18n 功用,真不错。

    然后是宿主运用查找

    val activities = requireContext().packageManager.queryIntentActivities(intent, PackageManager.MATCH_DEFAULT_ONLY or PackageManager.GET_META_DATA)
    activities.forEach {
        val activityInfo = it?.activityInfo ?: return@forEach
        val groups = activityInfo.metaData?.getString("group")?.split("/") ?: return@forEach
        val title = activityInfo.metaData?.getString("title") ?: return@forEach
        this.menu.loopAdd(groups).add(title).setOnMenuItemClickListener {
            intent.setPackage(requireContext().packageName).component = ComponentName(activityInfo.packageName, activityInfo.name)
            startActivity(intent)
            return@setOnMenuItemClickListener true
        }
    }
    private fun Menu.loopAdd(strings: List<String>): Menu {
        return strings.fold(this) { t, e ->
            t.addSubMenu(e)
        }
    }
    

    这段代码是从项目中复制的,所以仍是挺长的。

    首要榜首行获取可以处理相应的mimeType 的activity。PackageManager.GET_META_DATA 是有必要的,否则咱们不能取得那个meta-data。

    然后是经过loopAdd 迭代添加menu,fold 可以非常便利咱们实现迭代功用,但不需求咱们自己去写,究竟函数式编程。榜首次的t 是咱们传入的this,下一次的t 就不是this 了,而是t.addSubMenu(e) 的返回值,也便是下一个菜单, great。

    最终一步

    <queries>
        <intent>
            <action android:name="com.storyteller_f.action.giant_explorer.PLUGIN" />
            <category android:name="android.intent.category.DEFAULT" />
            <data
                android:mimeType="*/*"
                android:scheme="content" />
        </intent>
    </queries>
    

    谷歌不答应运用<uses-permission android:name="android.permission.QUERY_ALL_PACKAGES"/> 这样的广泛的权限,有必要明确指定咱们需求的查询的包。

  2. 第二种插件

    如果activity 没有在manifest 中声明,安卓会抛出一个异常,很显然咱们的插件的activity 是没有在manifest 中声明。

    你或许会说咱们可以运用hook 诈骗系统,并且有许多的库,都不用自己写,可是运用hook 的办法会使咱们的app 变得不稳定,在我看来属于下策,是在没有办法的时候才运用。

    那么咱们顺且自然就会想到运用Fragment 作为咱们的插件载体,即没有hook,也不需求处理生命周期,也不需求让咱们插件承继一个奇古怪怪的activity,完完全全契合谷歌的设计,也契合自己编程原则,岂不美哉。

    运用DexClassLoader 加载一个apk 文件,此class loader 会自动加载dex 文件,即便这个apk 中有多个dex 也能正常工作,great。

    val dexClassLoader = DexClassLoader(file.absolutePath, null, null, classLoader)
    val loadClass = dexClassLoader.loadClass("com.storyteller_f.yue_plugin.YueFragment")
    val newInstance = loadClass.newInstance()
    

    然后咱们还需求处理resounces,Android 的一切资源都是经过Resources 获取,并且Fragment 是直接运用的宿主activity 的Resources,再一次的great。

    /**
     * Return <code>requireActivity().getResources()</code>.
     */
    @NonNull
    final public Resources getResources() {
        return requireContext().getResources();
    }
    

    咱们运用懒加载的办法加载插件的资源。这个资源在apk 中,虽然咱们没有装置它。

    private val pluginResources by lazy {
        val packageArchiveInfo = packageManager.getPackageArchiveInfo(File(cacheDir, "app-debug.apk").absolutePath, 0)
        val applicationInfo = packageArchiveInfo?.applicationInfo
        if (applicationInfo != null)
            packageManager.getResourcesForApplication(applicationInfo)
        else null
    }
    

    然后是咱们的宿主activity

    override fun getResources(): Resources {
        val stackTrace = Thread.currentThread().stackTrace
        val listOf = listOf("com.storyteller_f.yue_plugin.ImageViewFragment", "com.storyteller_f.yue_plugin.YueFragment")
        if (stackTrace.any {
                listOf.contains(it.className)
            }) {
            return pluginResources!!
        }
        return super.getResources()
    }
    

    咱们不需求运用try-catch 的办法在找不到资源时从插件中加载,咱们直接判断发起此次调用时插件仍是正常的宿主activity,究竟Android 没有启用切换线程去获取Resources

    感觉安卓的设计便是为了我今日实现插件功用啊(开个打趣)。

  3. 第三种插件

    安卓的WebView 答应咱们运用addJavascriptInterfaceJavaScript 调用安卓的代码,这也是咱们第三种插件存在的主要根底。究竟不能为了一个插件功用把chromium 放进来。

    根底的设置一个WebView 就不讲了。

    val pluginManager = object : GiantExplorerPluginManager {
        @JavascriptInterface
        override fun fileInputStream(path: String) = getFileInstance(path, this@WebViewPluginActivity).fileInputStream
        @JavascriptInterface
        override fun fileOutputStream(path: String) = getFileInstance(path, this@WebViewPluginActivity).fileOutputStream
        @JavascriptInterface
        override fun listFiles(path: String): List<String> {
            return getFileInstance(path, this@WebViewPluginActivity).listSafe().let { filesAndDirectories ->
                filesAndDirectories.files.map {
                    it.fullPath
                } + filesAndDirectories.directories.map {
                    it.fullPath
                }
            }
        }
        @JavascriptInterface
        fun base64(path: String): String {
            val readBytes = fileInputStream(path).readBytes()
            return Base64.encodeToString(readBytes, Base64.NO_WRAP)
        }
    }
    webView.addJavascriptInterface(pluginManager, "plugin")
    

    前三个办法是第二种插件也需求用的,最终一个base64(path: String) 是,第三种插件独有的,用来给JavaScript 发送文件内容。

    演示一下在插件中显现咱们的图片:

    <html>
    <body>
    <img id="ci" src="">
    <script>
        document.write(file.fullPath())
        let ele = document.getElementById("ci")
        ele.src = "data:image/png;base64," + plugin.base64(file.fullPath())
    </script>
    </body>
    </html>
    

最终

写代码也要有所为,有所不为。写完博客,去看三体,great。