Setup a native app
...
Preconditions for Test & Submi...
'Forced Update' for your App

Edit the text of 'Forced Update'

8min

Purple Manager / Purple App



Summary

If you want to enable the 'Forced Update' feature to prompt your app users to update your Purple App to the latest version, you can change the text of the dialogue that appears on your user's device. This step is optional and is not required for the 'Forced Update' feature to work.

To change the text, go to Purple Manager, download the "textkeys.xlsx", change the text in the document and upload it back to Purple Manager.

The dialogue looks like this:

Document image


As changing the text of the dialogue is a native change, you need to rebuild and resubmit the app to the App Store(s) to make the change visible on your user's devices.

  • You can change the text of the 'Forced Update' dialogue at any time. However, a change to the text is only adopted in the app builds created afterwards. Older app versions that have already been released on the App Store(s) will keep their previous text. If you haven't yet released an app version to the App Store(s), you should make changes to the text as needed before submitting your app to the App Store(s).
  • The 'Forced Update' feature will be enabled after the submission (in the case of iOS even the approval of the review team) to the App Store(s) is successful.

Each of the three relevant translations is represented by a (text) key and has a default value as shown in this table:

Key

Translations (en)

app_force_update

Update App

app_force_update_message_android

You need to update the app before the content can be displayed. Please go to the Google Play Store and update the app to the latest version.

app_force_update_message_ios

To view the content, you need to update the app. Please go to the iTunes App Store and download the latest version of the app onto your device.



Preconditions



How to

1. Go to Purple Manager -> 'Apps' -> 'Overview'

Document image


2. Click on the three dots

Document image


3. Click on 'Translations' in the dropdown

Document image


4. Next to 'App translations' click on the download arrow

Document image


5. Leave the browser tab open and go to the downloads folder on your computer.

6. Open the downloaded document 'textkeys.xlsx' on your computer

7. Find the key 'app_force_update' (column 'A') and change the translation(s) in the same row accordingly. E.g. in the column 'de' (for German) and the column 'en' (for English)

Document image


8. Go to 'app_force_update_message_android' (column 'A') and change the translation(s) in the same row accordingly for the dialogue displayed on Android devices. E.g. in the column 'de' (for German) and the column 'en' (for English)

Document image


9. Go to 'app_force_update_message_ios' (column 'A') and change the translation(s) in the same row accordingly for the dialogue screen displayed on iOS devices. E.g. in the column 'de' (for German) and the column 'en' (for English)

Document image


10. Save your change to the file and close it.

11. Go back to the opened browser tab in Purple Manager.

12. Next to 'App translations' click on 'Upload translations'

Document image


13. Select the 'textkeys.xlsx' from your computer and upload it.

14. Rebuild the app, test your changes and submit the app to the app store(s).