kiot-cordova-plugin-home-console/README.md

This plugin allows your Android app to download and install compressed updates without the Google Play Store.

# kiot-cordova-plugin-home-console

## INSTALL

```shell
## to install
cordova plugin add kiot-cordova-plugin-home-console

## run your app on device
# than run this command in order to set your app as device owner
adb shell dpm set-device-owner io.homeconsole/io.kiotplugins.kioskplugin.KioskDeviceAdminReceiver

## to see current device owner
adb shell dumpsys device_policy | grep "admin"

## to reset current device owner (works only for  `android:testOnly="true"` apps)
adb shell dpm remove-active-admin io.homeconsole/io.kiotplugins.kioskplugin.KioskDeviceAdminReceiver
```

## UNINSTALL

## Android Device Owner Removal Commands

This guide provides ADB shell commands to remove device owner restrictions and uninstall the Home Console app (`io.homeconsole`).

### Step 1: Remove Device Policy Files

```bash
adb shell "rm -f /data/system/device_policies.xml /data/system/device_owner_2.xml /data/system/device_owner.xml /data/system/profile_owner.xml /data/system_ce/0/device_policies.xml && rm -rf /data/system/device_policies/ && settings put global lock_task_packages '' && stop && start"
```

### Step 2: After Reboot - Try Uninstalling

```bash
# After the device reboots, try these:
adb shell pm clear io.homeconsole
adb shell pm uninstall io.homeconsole
adb shell pm uninstall --user 0 io.homeconsole
```

### Alternative Method: Remove Device Admin First

```bash
# Remove the active admin with correct component name
adb shell dpm remove-active-admin io.homeconsole/io.kiotplugins.kioskplugin.KioskDeviceAdminReceiver

# Clear device owner
adb shell dpm clear-device-owner

# Check if removed
adb shell dumpsys device_policy | grep "admin"
```

### Verification Commands

```bash
# Check if device owner is cleared
adb shell dumpsys device_policy | grep "admin"
adb shell dumpsys device_policy | grep "owner"
adb shell dumpsys device_policy | grep "io.homeconsole"
```

### Nuclear Option - Factory Reset

If all else fails:

```bash
# This will completely wipe the device
adb shell am broadcast -a android.intent.action.FACTORY_RESET

# Or reboot to recovery
adb reboot recovery
```

### Notes

- Execute commands in the order provided
- Some commands may require root access
- Reboot the device after deleting policy files
- The device owner restrictions should be removed after file deletion and reboot
- Replace `io.homeconsole` with your actual package name if different

### Troubleshooting

If you get "Permission denied" errors:
1. Ensure your device has USB debugging enabled
2. Check if you have root access: `adb shell su`
3. Some files may not exist on all Android versions - this is normal