For the latest documentation, please refer to: https://github.com/FSpaceCore/SpaceCore

SDK Integration

Step 1. Dependency

implementation "com.tencent:mmkv-static:1.2.10"
implementation "com.google.code.gson:gson:2.9.1"
implementation "org.jetbrains.kotlin:kotlin-stdlib:1.5.30"

Step 2. Initialization

Add the following code to initialize in Application#attachBaseContext

FCore.get().init(this);

Please note that after calling `init()`, if the `FCore.get().isClient()` condition is true, please try not to do other initialization in the Application. If you encounter any problems, please contact technical support.

override fun attachBaseContext(base: Context) {
    super.attachBaseContext(base)
    FCore.get().init(this)
    FCore.get().setAllowSystemInteraction(true)
    FCore.get().setAutoPreloadApplication(true)
    if(FCore.isClient()) {
        return
    }
    // do something...
}

override fun onCreate() {
    super.onCreate()
    if(FCore.isClient()) {
        return
    }
    // do something...
}

Step 3. Installation

Method 1: App Clone

This method relies on the application that is already installed on the system. If the application is uninstalled from the system, the cloned app will also disappear.

FCore.get().installPackageAsUser("package_name", USER_ID)

Method 2: Running without installation

This method supports running without installation and will not be affected by system installation or uninstallation.

FCore.get().installPackageAsUser(new File("/sdcard/wechat.apk"), USER_ID)

Step 4. Launch sandboxed application

FCore.get().launchApk("package_name", USER_ID)

API Documentation

Rule Configuration System

When dealing with various applications, SpaceCore supports configuring different runtime parameters and virtual machine parameters to achieve adaptation. SpaceCore supports a powerful rule configuration system that can customize exclusive rules for each application. The rule library can be dynamically updated through cloud configuration. The supported rule functions are gradually under development.

PackageRule.Builder builder = new PackageRule.Builder("com.tencent.mm",
    /* Scoped process. Leave blank if the scope is all processes */
    "com.tencent.mm", "com.tencent.mm:tools", "com.tencent.mm:appbrand1", "com.tencent.mm:appbrand2")
    // disable a Activity
    .addBlackActivity("com.tencent.mm.plugin.base.stub.WXEntryActivity")
    // disable a broadcast
    .addBlackBroadcast("com.tencent.mm.plugin.appbrand.task.AppBrandTaskPreloadReceiver")
    // disable a service
    .addBlackService("com.tencent.mm.plugin.backup.backuppcmodel.BackupPcService")
    // disable a ContentProvider
    .addBlackContentProvider("androidx.startup.InitializationProvider")
    // preloading process, can pre-start a certain process to speed up the runtime experience
    .addPreloadProcessName("com.tencent.mm:appbrand1")
    // disable a process from starting
    .addBlackProcessName("com.tencent.mm:appbrand2")
    // deny access to a file
    .addBlackIO("/proc/self/maps")
    // redirect a certain file
    .addRedirectIO("/proc/self/cmdline", "/proc/self/fake-cmdline")
    // hide root
    .isHideRoot(true)
    // hide SIM
    .isHideSim(true)
    // hide VPN
    .isHideVpn(true)
    // many more...
    // set language
    .setLanguage("zh")
    // set region
    .setRegion("CN")
    // set timezone
    .setTimeZone("Asia/Shanghai");

PackageRule build = builder.build();

// add a rule
FCore.get().addRule(build);

// if there are multiple rules, put them in FRule
FRule fRule = new FRule(builder.build(), builder.build(), builder.build());
FCore.get().addFRule(fRule);

// support fetching configuration content from remote cloud
String json = new Gson().toJson(fRule);
// load json rule
FCore.get().addFRuleContent(json);