Changes

no edit summary
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