OPPO devices revert to Setup Wizard / Welcome screen after successful Esper enrollment

Android

If your OPPO device completes Esper enrollment successfully but returns to the Setup Wizard or Welcome screen instead of your managed launcher, this article will help you resolve the issue.

Before you begin

Verify that your device shows as enrolled in the Esper Console. This issue occurs when the device is fully provisioned from Esper's perspective but the OPPO Setup Wizard continues to appear after enrollment completes.

You'll need:

A computer with ADB (Android Debug Bridge) installed
USB debugging enabled on your OPPO device
Your device's model number and Android/firmware version

Step 1: Check Device Owner status

Confirm that your device retained Device Owner rights after enrollment.

Connect your OPPO device to a computer via USB.
Open a terminal or command prompt and run:
```
adb shell dpm list-owners
```
Verify that the Esper Agent (Esper Agent) is listed as the owner.

Step 2: Identify the Setup Wizard package name

OPPO uses different package names for the Setup Wizard depending on the device model and firmware version. You need to find the correct package name before disabling it.

Connect your device via USB and open a terminal.

Run the following commands to search for setup-related packages:

adb shell pm list packages | grep -i setup
adb shell pm list packages | grep -i wizard
adb shell pm list packages | grep -i oobe

Note the package name that appears in the results. Common OPPO package names include com.mediatek.oobe.main, but your device may differ.

Step 3: Disable the Setup Wizard package

Once you've identified the correct package name, disable it to prevent the Setup Wizard from appearing.

Replace PACKAGE_NAME in the command below with the package name you found in Step 2.

Run:

adb shell pm disable-user --user 0 PACKAGE_NAME

Press the Home button on your device. You should now see your Esper managed launcher or configured home screen instead of the Setup Wizard.

Step 4: Verify the fix

Test that the Setup Wizard no longer appears when navigating your device.

Press the Back button on your device.
Press the Home button.
Confirm that you land on the managed launcher or home screen each time, not the Setup Wizard welcome page.
Reboot your device and verify the behavior persists.

If the issue persists

If disabling the Setup Wizard package doesn't resolve the issue, or if the package re-enables after a reboot:

Verify that you disabled the correct package name for your specific OPPO model.
Check whether a newer Esper agent version is available that includes OPPO compatibility improvements.
If you have multiple OPPO devices affected, gather the model numbers and Android/firmware versions for all affected units to identify whether this is a firmware-version-specific issue.
If you originally provisioned via QR code, try reprovisioning using the AFW method (afw#esper) as an alternative approach.

Collect logs for support

If you need to contact Esper Support, collect the following diagnostic information:

Capture ADB logs immediately after provisioning:

adb logcat -b all -d > oppo_setup_wizard_logs.txt

Note your device's model number, Android version, and firmware version.
Document the provisioning method you used (QR code, Zero-Touch, KME, etc.).
Include these details when you submit your support request.

Still need help?

If you've tried these steps and the Setup Wizard still appears, submit a support ticket. Include your OPPO device model, Android version, provisioning method, and the ADB logs from the section above. This information will help our team diagnose and resolve the issue more quickly.