| Line 1: |
Line 1: |
| − | <pre style="color: black"> | + | <pre class="header-style">The App Install/Remove/Update trigger fires when an application is installed, removed, or updated on the device. This trigger can monitor all apps or specific applications that you select.</pre> |
| − | This trigger can be configured to fire when you install an application, uninstall an application or when an application update has completed.
| |
| − | </pre> | |
| − | <pre style="color: #626567">
| |
| − | The following [magic text] is available when this trigger fires.
| |
| | | | |
| − | [app_name] - the name of the app.
| + | ''' Options ''' |
| | | | |
| − | [app_package] - the package of the app.
| + | * '''Application Installed''' - Trigger fires when a new application is installed |
| − | </pre>
| + | * '''Application Updated''' - Trigger fires when an existing application is updated |
| | + | * '''Application Removed''' - Trigger fires when an application is uninstalled |
| | | | |
| − | <pre style="color: Teal">
| + | ''' Application Selection ''' |
| − | Supported configurations:
| |
| | | | |
| − | Any app:
| + | After choosing the event type, you can specify which applications to monitor: |
| − | Any application that is installed, uninstalled or updated.
| |
| | | | |
| − | Select applications: | + | * '''Any Application''' - Trigger fires for any app that matches the selected event |
| − | One or more specific applications.
| + | * '''Select Applications''' - Choose specific applications to monitor. Only events for the selected apps will trigger the macro. |
| | | | |
| − | </pre><br/>
| + | When selecting specific applications, a searchable list of installed apps is shown. You can: |
| − | '''Example Usage:'''<br/>
| + | * Search for apps by name |
| − | A notification will be displayed when an app (specific or any) is updated by creating a notification that says "An app was updated. (app name)
| + | * Show non-launchable apps using the checkbox |
| − | <pre style="background-color: red; color: white;">
| + | * Select multiple applications |
| − | Application Updated
| |
| − | </pre>
| |
| − | <pre style="background-color: #1665B0; color: white;">
| |
| | | | |
| − | Display Notification: Title: An app was updated.| Notification text: [app_name]
| + | ''' Magic Text ''' |
| − | </pre> | + | |
| − | <pre style="background-color: green; color: white;"> | + | When this trigger is active, you can use magic text to access information about the app: |
| − | </pre> | + | * Package name of the installed/removed/updated application |
| | + | |
| | + | ''' Examples ''' |
| | + | |
| | + | ''Example 1: Log All App Installations'' |
| | + | <pre class="trigger-style">Triggers |
| | + | |
| | + | Application Installed (Any Application)</pre> |
| | + | <pre class="action-style">Actions |
| | + | |
| | + | Write to File: Installed app: {package_name} at {hour:minute:second}</pre> |
| | + | |
| | + | ''Example 2: Notify When Specific App Updates'' |
| | + | <pre class="trigger-style">Triggers |
| | + | |
| | + | Application Updated (WhatsApp)</pre> |
| | + | <pre class="action-style">Actions |
| | + | |
| | + | Notification: WhatsApp has been updated</pre> |
| | + | |
| | + | ''' Notes ''' |
| | + | |
| | + | * The trigger listens for the system broadcasts ACTION_PACKAGE_ADDED and ACTION_PACKAGE_REMOVED |
| | + | * MacroDroid itself is excluded from the app selection list since you cannot receive notifications for your own app |
| | + | * The trigger uses a shared receiver for efficiency when multiple macros use this trigger |
| | + | * When selecting specific apps, the previously selected apps are shown at the top of the list for convenience |