Files
OwnDroid/Readme-en.md
BinTianqi a21db0da70 Add FAQ to READMEs
Fix #93: list hidden apps in package selector
2025-01-19 15:02:26 +08:00

126 lines
4.2 KiB
Markdown

[简体中文](Readme.md)
# OwnDroid
Use Android Device owner privilege to manage your device.
## Features
- System
- Options: disable camera, disable screenshot, master volume mute, disable USB signal...
- Permission policy
- _Wipe data_
- ...
- Network
- Minimum Wi-Fi security level
- Always-on VPN
- Network logging
- ...
- Work profile
- Create work profile
- Suspend personal apps
- ...
- Applications
- Suspend/hide app
- Block app uninstallation
- Install/uninstall app
- ...
- User restriction
- Network: disable configuring mobile network, disable configuring Wi-Fi, disable SMS, disable outgoing calls...
- Connection: disable bluetooth, disable configuring location, disable USB file transfer, disable printing...
- Applications: disable installing/uninstalling app...
- Users: disable adding/removing/switching user...
- Media: disable configuring brightness, disable adjusting volume...
- Other: disable modifying accounts, disable configuring locale, disable factory reset, disable debug features...
- User manager
- User information
- Start/switch/stop/delete user
- Create user
- ...
- Password and keyguard
- _Reset password_
- Require password complexity
- Set screen timeout
- ...
## Activate
- Shizuku (recommended)
- Execute command in adb shell: `dpm set-device-owner com.bintianqi.owndroid/.Receiver`
## FAQ
### Activating
#### Already some accounts on the device
```text
java.lang.IllegalStateException: Not allowed to set the device owner because there are already some accounts on the device
```
Solutions:
- Freeze apps who hold those accounts.
- Delete these accounts.
- Use LSPosed module [HookDPM](https://github.com/BinTianqi/HookDPM).
#### Already several users on the device
```text
java.lang.IllegalStateException: Not allowed to set the device owner because there are already several users on the device
```
Solutions:
- Delete secondary users.
- Use LSPosed module [HookDPM](https://github.com/BinTianqi/HookDPM).
> [!NOTE]
> Some systems have features such as app cloning and children space, which are usually users.
#### MIUI
```text
java.lang.SecurityException: Neither user 2000 nor current process has android.permission.MANAGE_DEVICE_ADMINS.
```
Solutions:
- Enable `USB debugging (Security setting)` in developer options.
- Execute activating command in root shell.
#### ColorOS
```text
java.lang.IllegalStateException: Unexpected @ProvisioningPreCondition
```
Solution: Use OwnDroid testkey version
## API
| ID | Description | Extras | Minimum Android version |
|:---------:|------------------|---------------------------------------|:-----------------------:|
| HIDE | Hide an app | `package`: package name of target app | |
| UNHIDE | Unhide an app | `package`: package name of target app | |
| SUSPEND | Suspend an app | `package`: package name of target app | 7 |
| UNSUSPEND | Unsuspend an app | `package`: package name of target app | 7 |
| LOCK | Lock screen | | |
Use this API in adb shell
```shell
am broadcast -a com.bintianqi.owndroid.action.<ID> -n com.bintianqi.owndroid/.ApiReceiver --es key <API_KEY>
# Example
am broadcast -a com.bintianqi.owndroid.action.HIDE -n com.bintianqi.owndroid/.ApiReceiver --es key abcdefg --es package com.example.app
```
If the return value is 0, the operation is successful.
## License
[License.md](LICENSE.md)
> Copyright (C) 2024 BinTianqi
>
> This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.
>
> This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
>
> You should have received a copy of the GNU General Public License along with this program. If not, see <https://www.gnu.org/licenses/>.