Multi-process apps

Android apps can consist of one or more processes. To run services or activities in a process other than the main one, you need to add a process name to your activity or service. To do this, add an android:process property to your activity or service node in your AndroidManifest.xml file.

<activity
    android:name=".YourActivity"
    android:process=":YourProcessName">
</activity>

<service
    android:name=".YourService"
    android:process=":YourProcessName">
</service>

Defining a process name forces the activity or service to run in a process other than the main process.

By default, your main process name is the same as your app package name. For example, if your app package name is com.example.myapp, your main process is also named com.example.myapp. The above examples run in a process underneath this main process called com.example.myapp:YourProcessName.

The Adjust SDK doesn’t currently support measurement for more than one process in an app. If your app uses multiple processes, set the main process name in your AdjustConfig object.

1
val appToken = "{YourAppToken}"
2
val environment = AdjustConfig.ENVIRONMENT_SANDBOX
3

4
val config = AdjustConfig(this, appToken, environment)
5
config.setProcessName("com.example.myapp")
6

7
Adjust.onCreate(config)

1
String appToken = "{YourAppToken}";
2
String environment = AdjustConfig.ENVIRONMENT_SANDBOX;
3

4
AdjustConfig config = new AdjustConfig(this, appToken, environment);
5
config.setProcessName("com.example.myapp");
6

7
Adjust.onCreate(config);

1
let appToken = "{YourAppToken}";
2
let environment = AdjustConfig.EnvironmentSandbox;
3
let adjustConfig = new AdjustConfig(appToken, environment);
4
adjustConfig.setProcessName("com.example.myapp");
5

6
Adjust.onCreate(adjustConfig);

To change the name of your main process, modify the android:process property of the application node in your AndroidManifest.xml file.

<application
  android:name=".YourApp"
  android:icon="@drawable/ic_launcher"
  android:label="@string/app_name"
  android:theme="@style/AppTheme"
  android:process=":YourMainProcessName">
</application>

Then set your process name in your AdjustConfig object.

1
val appToken = "{YourAppToken}"
2
val environment = AdjustConfig.ENVIRONMENT_SANDBOX
3

4
val config = AdjustConfig(this, appToken, environment)
5
config.setProcessName("com.example.myapp:YourMainProcessName")
6

7
Adjust.onCreate(config)

1
String appToken = "{YourAppToken}";
2
String environment = AdjustConfig.ENVIRONMENT_SANDBOX;
3

4
AdjustConfig config = new AdjustConfig(this, appToken, environment);
5
config.setProcessName("com.example.myapp:YourMainProcessName");
6

7
Adjust.onCreate(config);

1
let appToken = "{YourAppToken}";
2
let environment = AdjustConfig.EnvironmentSandbox;
3
let adjustConfig = new AdjustConfig(appToken, environment);
4
adjustConfig.setProcessName("com.example.myapp:YourMainProcessName");
5

6
Adjust.onCreate(adjustConfig);

This informs the Adjust SDK of the main process name. The SDK only initializes in the main process. If you try to use the SDK in another process you’ll see the following in the output logs:

1
05-06 17:15:06.885    8743-8743/com.example.myapp:YourProcessName I/Adjust﹕ Skipping initialization in background process (com.example.myapp:YourProcessName)