| Line 1: |
Line 1: |
| − | <pre style="background-color: #EEEEEE; 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><br> | |
| − | <pre style="background-color: #EEEEEE; color: Black;">
| |
| − | 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><br>
| + | * '''Application Updated''' - Trigger fires when an existing application is updated |
| | + | * '''Application Removed''' - Trigger fires when an application is uninstalled |
| | | | |
| − | <pre style="background-color: #EEEEEE; color: Black;">
| + | ''' 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.</pre>
| + | * '''Select Applications''' - Choose specific applications to monitor. Only events for the selected apps will trigger the macro. |
| − | <br/>
| |
| − | '''Example Usage:'''<br/> | |
| − | 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)
| |
| | | | |
| − | <pre style="background-color: #AC2424; color: white; border-radius: 10px; padding: 10px;">
| + | When selecting specific applications, a searchable list of installed apps is shown. You can: |
| − | Triggers
| + | * Search for apps by name |
| | + | * Show non-launchable apps using the checkbox |
| | + | * Select multiple applications |
| | | | |
| − | Application Updated
| + | ''' Magic Text ''' |
| − | </pre><br>
| |
| − | <pre style="background-color: #1665B0; color: white; border-radius: 10px; padding: 10px;">
| |
| − | Actions
| |
| | | | |
| − | Display Notification: Title: An app was updated.| Notification text: [app_name]
| + | When this trigger is active, you can use magic text to access information about the app: |
| − | </pre><br>
| + | * Package name of the installed/removed/updated application |
| − | <pre style="background-color: green; color: white; border-radius: 10px; padding: 10px;">
| |
| − | Constraints
| |
| | | | |
| | + | ''' Examples ''' |
| | | | |
| − | </pre><br> | + | ''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 |