Skip to content

Country restrictions, Update, General notices

When servicing an app, there are situations where you need to either not service the app in certain countries or display a notification popup to update the app to the latest version. In this way, the Hive SDK provides notification popups that can respond to the following situations.

Popup Description
Country Restriction Blocks app usage from specific countries based on IP address
Update Blocks usage of a specific version of the app and provides a link for updates
General Notice Used to inform about app updates that are not mandatory and to expose important notices that must be communicated to all users

Exposure method

  1. Register the desired notification popup in the Hive console.
  2. The registered popup will be displayed when you run the SDK initialization.

The country restrictions, updates, and general notice pop-ups can only use the default UI provided by the Hive SDK.

Exposure order

Notice pop-ups will not be displayed simultaneously. If you have registered all notice pop-ups (country restrictions, updates, general notices, server maintenance) in the console, the order of displaying the notice pop-ups is as follows.

  1. Country Restriction Popup
    1. Role: Notify the user of access denial when accessing from a specific country
    2. Next Step: Encourage the user to exit the app
  2. Update Popup
    1. Role: (If not subject to country restrictions) Inform the user about using an outdated version of the app
    2. Next Step: Encourage the user to exit the app and redirect them to the app market to update to the latest version
  3. General Notice Popup
    1. Role: (If not subject to country restrictions and the app is up to date) Display information about app updates and any notices to be communicated
  4. Server Maintenance Popup
    1. Role: (If not subject to country restrictions, the app is up to date, and after informing about general notices) Notify about server maintenance
    2. Next Step: Encourage the user to exit the app

Example 1: when a user accesses from a restricted country

If a user accesses from a country with restricted access, only the country restriction popup will be displayed and the app will close. If the country restriction popup has not been registered in the console, the country restriction popup will not be displayed, and it will proceed to the update popup display stage as shown in example 2 below.

Example 2: when the user accesses from allowed countries

If the user has accessed from a country that is allowed, the country restriction popup will not be displayed. The popup that is displayed afterwards will vary as shown below, depending on whether the app is the latest version or not.

If the app is an old version (if the app has not been updated)

Displays an update popup. The update popup prompts the user to update the app to the latest version from the market after exiting the app.

If the app is the latest version (if the app has been updated)

Displays a general notice popup without showing the update popup. If the server is under maintenance, it will display the server maintenance popup.

Using Google in-app updates

Hive SDK supports the Google In-App Updates feature. In-app updates allow the app to be updated to the latest version in the background without closing the app, according to the Update Popup Settings. In-app updates can only be used under the following conditions.

  • Supported markets: Google Play Store
  • Supported devices: Android mobile, Android tablet, ChromeOS devices
  • App file formats: Supports both AAB (Android App Bundle) and APK
    • However, APK expansion files (.obb files) are not supported
    • AAB supports a maximum size of 200MB, and APK supports a maximum size of 150MB