Topic: Profiles

[MuntashirAkon]

Profiles are useful for running various tasks (see #61). In this issue, I'll discuss how profiles will be implemented.

Profiles are simple json files consisting of various mandatory and optional keys:

• type: (Integer) Profile type, currently 0 (reserved for future)
• version: (Integer) Profile version, currently 1 (reserved for future)
• allow_routine: (Boolean) [Optional] Whether to allow routine operations for this profile (default: true)
• state: (String) [Optional] on or off. Denotes the current mode of operations (e.g., on with disabled in misc means the packages will be disabled). If not set, the mode of operation will be determined during runtime or for routine operations, when the routine is being configured.
• name: (String) Name of the profile (unique, same as file name for internal use)
• packages: (String[]) A list of packages
• components: (String[]) [Optional] A list of components, if a package doesn't have one or more components, no errors will be reported
• app_ops: (Integers[]) [Optional] App op values.
• permissions: (String[]) [Optional] A list of permissions, if a package doesn't have one or more permissions, no errors will be reported.
• backup_data: (Object) [Optional] Backup app data with flags (See App Data Backup/Restore #30)
  • flags: (Integer) [Optional] Backup flags (default will be used if not given)
  • name: (String) [Optional] Backup name (if backup multiple is set)
• export_rules: (Integer) [Optional] Export blocking rules from the packages with flags (See Import/Export blocking rules with compatibility #24). The rules are saved in a single file called rules_<profile_name>.tsv in the app backup directory
• misc: (String[]) [Optional] Contains other rules that doesn't need additional information. Presence of any of these values means they are activated. Flags could be used instead but it will reduce readability.
  • disable: [Optional] Disable the packages itself
  • force_stop: [Optional] Force-stop (freeze) the packages
  • clear_cache: [Optional] Clear cache from the packages
  • clear_data: [Optional] Clear data from the packages
  • block_trackers: [Optional] Block trackers form the packages, if a package does not have any tracker, it will be ignored without errors
  • backup_apk: [Optional] Backup apk files (or apks for bundled apps)

[MuntashirAkon]

Milestones

• v2.5.16: Backend and UI development (still incomplete)
• v2.5.17: Create or import new profile and select apps Postponed as this is going to be a stable release.
• v2.5.18: Create or import new profile (2cdfacc), export profile (5a0539b), delete profile (81f3d7c), duplicate profile (31fc894) and select apps (b5f3a4a), remove apps (631c45d)
• v2.5.19: Add/edit configurations (c4aa462 and 0e850f0), Apply profile (c2d18ba)