JSPF (Java Simple Plugin Framework) 是一個輕量級插件框架,整合了 IoC 容器概念,支援在 Android 上動態加載、管理插件。本文演示如何在 Android 專案中引入 JSPF,並通過 PluginManager 載入插件實現介面調用。
在 build.gradle 中添加 JSPF 核心庫(需自行編譯或從 Maven Central 獲取對應版本):
dependencies {
implementation 'net.xeoh.plugins:jspf-core:1.3.0' // 示例坐標,請確認最新版本
}
// 插件介面(宿主與插件共享)
package de.jspfdemo.plugins;
public interface CoolPlugin {
String sayHello();
}
// 插件實現(可作為獨立模組/APK 部署)
package de.jspfdemo.plugins.impl;
import de.jspfdemo.plugins.CoolPlugin;
public class CoolPluginImpl implements CoolPlugin {
@Override
public String sayHello() {
return "Hello from JSPF Plugin!";
}
}
package de.jspfdemo;
import net.xeoh.plugins.base.PluginManager;
import net.xeoh.plugins.base.impl.PluginManagerFactory;
import net.xeoh.plugins.base.util.uri.ClassURI;
import android.app.Activity;
import android.os.Bundle;
import android.widget.TextView;
import de.jspfdemo.plugins.CoolPlugin;
import de.jspfdemo.plugins.impl.CoolPluginImpl;
public class JSPFDemoActivity extends Activity {
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
// 1. 創建插件管理器
PluginManager pm = PluginManagerFactory.createPluginManager();
// 2. 通過 ClassURI 載入插件類(此處為同進程演示,實際可載入外部 Dex/APK)
pm.addPluginsFrom(new ClassURI(CoolPluginImpl.class).toURI());
// 3. 獲取插件實例
CoolPlugin plugin = pm.getPlugin(CoolPlugin.class);
// 4. 調用插件功能更新 UI
TextView textView = findViewById(R.id.textView);
textView.setText(plugin.sayHello());
}
}
生產環境中,插件通常以獨立 APK 形式下發。需結合 DexClassLoader 或 PathClassLoader 加載外部 APK 中的類,再註冊至 PluginManager。核心流程:
DexClassLoader(apkPath, optimizedDir, null, getClassLoader())。loadClass() 獲取插件實現類,實例化並註冊至 JSPF。uses-library 或遷移至官方 Dynamic Feature Module / Play Feature Delivery。JSPF 為 Android 插件化提供了標準化的 IoC 風格 API,適合輕量級模組化場景;大型專案建議評估 VirtualApk、RePlugin 或官方 Dynamic Delivery 方案。