# Update Strategies ## Status Bar (default) ![](/files/-LG6o8JX4Jt1h57j7cFX) * `PushLink.setCurrentStrategy(StrategyEnum.STATUS_BAR);` * Title message: "New version of \[App Name]" * Description message: "Click to Update" * Remains on the status bar until the installation happens. * Clear the message if the admin changes back to an earlier version before the installation. {% hint style="warning" %} Check if your application has requested permission for notification or if you manually allowed it in Android settings. {% endhint %} ## Friendly Popup (useful for full-screen apps) ![](/files/-LG6p85ZaWw3U_pdKHjY) * `PushLink.setCurrentStrategy(StrategyEnum.FRIENDLY_POPUP);` * Default message: "New version of \[App Name]. Do you want to update it?". * Default buttons: \[Not Now]\[Update]. * It remains until the user presses \[Not Now] or \[Update] (The back button is blocked). * Default reminder: 3 hours * Hide the popup if the admin changes back to an earlier version before the installation. {% hint style="info" %} Don't forget to call `PushLink.setCurrentActivity(this);` inside `onResume` {% endhint %} ```java //Only for popups (FRIENDLY_POPUP or ANNOYING_POPUP) //You MUST do this, otherwise popups will not work. //Call it in the Activity you want to show the popup. //You can show the popup in many screens by adding this in more than one Activity. @Override protected void onResume() { super.onResume(); PushLink.setCurrentActivity(this); } ``` ## Annoying Popup (useful for full-screen when updates can't wait) ![](/files/-LG6pp5rP9vxQY-Ev7rz) * `PushLink.setCurrentStrategy(StrategyEnum.ANNOYING_POPUP);` * Default message: "For security reasons \[App Name] needs to be updated!" * Default button: \[Update]. * Very insistent. It remains until the user presses \[Update] (The dismiss button is blocked). * Hide the popup if the admin changes back to an earlier version before the installation. {% hint style="info" %} Don't forget to call `PushLink.setCurrentActivity(this);` inside `onResume` {% endhint %} ```java //Only for popups (FRIENDLY_POPUP or ANNOYING_POPUP) //You MUST do this, otherwise popups will not work. //Call it in the Activity you want to show the popup. //You can show the popup in many screens by adding this in more than one Activity. @Override protected void onResume() { super.onResume(); PushLink.setCurrentActivity(this); } ``` ## Custom (take complete control of your installation) * `PushLink.setCurrentStrategy(StrategyEnum.CUSTOM);` * When using the CUSTOM strategy, pushlink doesn't display anything and will broadcast two actions. * `[your.package.name].pushlink.APPLY` is sent EVERY 30 seconds (more or less) when there is a downloaded but not applied new APK. The user has to handle those multiple broadcasts. * `[your.package.name].pushlink.GIVEUP` is sent ONCE when the user gives up the update (in the web admin) before it has been applied. {% hint style="info" %} It is useful when the requirement is building a fancier and more modern notification, executing extra steps, or performing a silent background update. {% endhint %} ```java registerReceiver(new BroadcastReceiver() { @Override public void onReceive(Context context, Intent intent) { Uri apkUri = (Uri) intent.getExtras().get("uri"); //enjoy the apk uri //notice this will be called every 30s (more or less). You need to handle this. } }, new IntentFilter(getPackageName() + ".pushlink.APPLY")); ``` {% hint style="warning" %} Do NOT register this receiver in AndroidManifest.xml. If you do that, CUSTOM will not work in **Android Oreo.** {% endhint %} ## Background * Installing APK without user interaction * Silent updates * Zero-touch updates * KIOSK apps * POS - Point of sale apps * Dedicated devices * COSU - Corporate Owned Single Use devices ![](/files/-LG6qLKcqFr3_ZSSOxUs) [**Learn how to update apps in the background with CUSTOM strategy.**](https://github.com/pushlink/background-device-owner) ## Idle Sometimes, you want to avoid undesired popups, notifications, or restarts during user interaction. By default `idle` is `true` . This means the installation will start after the new APK download. If you call `PushLink.idle(false)` , Pushlink will never fire the installation process. Knowing that you can switch this value to control updates. {% hint style="danger" %} **Manually setting up this property can be dangerous**. If, for some reason, the program doesn’t set `idle` back to `true`Pushlink will lose the ability to update the app, and you’ll need to update the device manually. {% endhint %} ## Customization You can customize the built-in strategies like this: ```java //If you use StatusBarStrategy StatusBarStrategy sbs = (StatusBarStrategy) PushLink.getCurrentStrategy(); sbs.setStatusBarTitle("Hello, there is a new version"); sbs.setStatusBarDescription("Click to be happy"); //If you use FriendlyPopUpStrategy FriendlyPopUpStrategy fps = (FriendlyPopUpStrategy) PushLink.getCurrentStrategy(); fps.setPopUpMessage("New version available"); fps.setNotNowButton("No, thanks!"); fps.setUpdateButton("Ok, lets go"); fps.setReminderTimeInSeconds(60 * 60); //one hour //If you use AnnoyingPopUpStrategy AnnoyingPopUpStrategy fps = (AnnoyingPopUpStrategy) PushLink.getCurrentStrategy(); fps.setPopUpMessage("New version available"); fps.setUpdateButton("Ok, lets go"); ``` --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.pushlink.com/strategies.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.