Activator Functions

Overview

Activator module functions operate the phone through an activator program running on a PC
The activator module object prefix is tjCenter
Phone and activator must be on the same LAN with network connectivity; connect the phone via WiFi or USB
For standalone activator, see Advanced — Standalone Activator Tutorial

tjCenter.setCenterUrl Set Standalone Activator Address

Set the address of the standalone activator
Requires EC iOS standalone 2.0+
@param url Activator address
@return {string} null or "" on success; otherwise an error message

1
function main() {
2
    // Activator port is usually 8020; change only the PC IP
3
    let set = tjCenter.setCenterUrl("http://192.168.2.6:8020")
4
    if (set == null || set == "") {
5
        logd("setCenterUrl success: " + set)
6
    } else {
7
        logd("setCenterUrl failed: " + set)
8
        return
9
    }
10
}
11

12
main();

tjCenter.appLaunch Launch App

Launch an app through the standalone activator
Requires EC iOS standalone 2.0+
@param deviceId Device ID
@param bundleId Bundle ID
@param killExist Kill existing process
@return {string} null or "" on success; otherwise an error message

1
function main() {
2
    let set = tjCenter.setCenterUrl("http://192.168.2.6:8020")
3
    if (set == null || set == "") {
4
        logd("setCenterUrl success: " + set)
5
    } else {
6
        logd("setCenterUrl failed: " + set)
7
        return
8
    }
9
    let deviceId = device.getDeviceId()
10
    logd("current deviceId : " + deviceId)
11

12
    let appLaunch = tjCenter.appLaunch(deviceId, "com.tencent.mttlite", false)
13
    if (appLaunch == null || appLaunch == "") {
14
        logd("appLaunch success ")
15
    } else {
16
        logd("appLaunch failed: " + appLaunch)
17
        return
18
    }
19
}
20

21
main();

tjCenter.appKillByBundleId Kill App by Bundle ID

Kill an app through the standalone activator
Requires EC iOS standalone 2.0+
@param deviceId Device ID
@param bundleId Bundle ID
@return {string} null or "" on success; otherwise an error message

1
function main() {
2
    let set = tjCenter.setCenterUrl("http://192.168.2.6:8020")
3
    if (set == null || set == "") {
4
        logd("setCenterUrl success: " + set)
5
    } else {
6
        logd("setCenterUrl failed: " + set)
7
        return
8
    }
9
    let deviceId = device.getDeviceId()
10
    logd("current deviceId : " + deviceId)
11

12
    let appKillByBundleId = tjCenter.appKillByBundleId(deviceId, "com.tencent.mttlite")
13
    if (appKillByBundleId == null || appKillByBundleId == "") {
14
        logd("appKillByBundleId success")
15
    } else {
16
        logd("appKillByBundleId failed: " + appKillByBundleId)
17
        return
18
    }
19
}
20

21
main();

tjCenter.stopApp Kill App

Kill an app through the standalone activator (alternative implementation)
Requires EC iOS standalone 2.0+
@param deviceId Device ID
@param bundleId Bundle ID
@return {string} null or "" on success; otherwise an error message

1
function main() {
2
    let set = tjCenter.setCenterUrl("http://192.168.2.6:8020")
3
    if (set == null || set == "") {
4
        logd("setCenterUrl success: " + set)
5
    } else {
6
        logd("setCenterUrl failed: " + set)
7
        return
8
    }
9
    let deviceId = device.getDeviceId()
10
    logd("current deviceId : " + deviceId)
11

12
    let stopApp = tjCenter.stopApp(deviceId, "com.tencent.mttlite")
13
    if (stopApp == null || stopApp == "") {
14
        logd("stopApp success")
15
    } else {
16
        logd("stopApp failed: " + stopApp)
17
        return
18
    }
19
}
20

21
main();

tjCenter.flushDevImage Flash Developer Image

Flash the developer image through the standalone activator
Requires EC iOS standalone 2.0+
@param deviceId Device ID
@return {string} null or "" on success; otherwise an error message

1
function main() {
2
    let set = tjCenter.setCenterUrl("http://192.168.2.6:8020")
3
    if (set == null || set == "") {
4
        logd("setCenterUrl success: " + set)
5
    } else {
6
        logd("setCenterUrl failed: " + set)
7
        return
8
    }
9
    let deviceId = device.getDeviceId()
10
    logd("current deviceId : " + deviceId)
11

12
    let devImage = tjCenter.flushDevImage(deviceId)
13
    if (devImage == null || devImage == "") {
14
        logd("flushDevImage success")
15
    } else {
16
        logd("flushDevImage failed: " + devImage)
17
        return
18
    }
19
}
20

21
main();

tjCenter.startAgent Start Agent for Automation

Start the agent program through the standalone activator
Requires setting the agent bundle ID on the activator web page first
See Advanced — Standalone Activator Tutorial
Requires EC iOS standalone 2.0+
@param deviceId Device ID
@return {string} null or "" on success; otherwise an error message

1
function main() {
2
    let set = tjCenter.setCenterUrl("http://192.168.2.6:8020")
3
    if (set == null || set == "") {
4
        logd("setCenterUrl success: " + set)
5
    } else {
6
        logd("setCenterUrl failed: " + set)
7
        return
8
    }
9
    let deviceId = device.getDeviceId()
10
    logd("current deviceId : " + deviceId)
11
    let agent = tjCenter.startAgent(deviceId)
12
    if (agent == null || agent == "") {
13
        logd("startAgent success: " + set)
14
    } else {
15
        logd("startAgent failed: " + set)
16
        return
17
    }
18
}
19

20
main();

tjCenter.authInit Initialize Device

Initialize the device through the standalone activator
Requires setting the main app bundle ID on the activator web page first
Usually not needed if initialization was done on the web page
See Advanced — Standalone Activator Tutorial
This kills and restarts the current main app process
Requires EC iOS standalone 2.0+
@param deviceId Device ID
@return {string} null or "" on success; otherwise an error message

1
function main() {
2
    let set = tjCenter.setCenterUrl("http://192.168.2.6:8020")
3
    if (set == null || set == "") {
4
        logd("setCenterUrl success: " + set)
5
    } else {
6
        logd("setCenterUrl failed: " + set)
7
        return
8
    }
9
    let deviceId = device.getDeviceId()
10
    logd("current deviceId : " + deviceId)
11
    let d = tjCenter.authInit(deviceId)
12
    if (d == null || d == "") {
13
        logd("authInit success: " + set)
14
    } else {
15
        logd("authInit failed: " + set)
16
        return
17
    }
18
}
19

20
main();

tjCenter.setWifiCon Enable or Disable WiFi Connection to PC

Enable or disable WiFi connection to the PC
Requires EC iOS standalone 2.0+
@param deviceId Device ID
@param status 1 enable, 2 disable
@return {string} null or "" on success; otherwise an error message

1
function main() {
2
    let set = tjCenter.setCenterUrl("http://192.168.2.6:8020")
3
    if (set == null || set == "") {
4
        logd("setCenterUrl success: " + set)
5
    } else {
6
        logd("setCenterUrl failed: " + set)
7
        return
8
    }
9
    let deviceId = device.getDeviceId()
10
    logd("current deviceId : " + deviceId)
11
    let d = tjCenter.setWifiCon(deviceId, "1")
12
    if (d == null || d == "") {
13
        logd("setWifiCon success: " + set)
14
    } else {
15
        logd("setWifiCon failed: " + set)
16
        return
17
    }
18
}
19

20
main();