Pre-requisites
- As a tester, you will need an Applanga account. Either one will be provided to you or you will be asked to provide your email address and will receive an account invite via mail.
- You will need the Chrome browser installed. Applanga is accessible in any browser however it's most optimized for Chrome. Some features might not be available in other browser types
- You will need a build of the app that should be tested installed on your phone
- You will need to know the name of the project on Applanga. Either the name and/or a link to the project on Applanga will be provided to you via mail.
- Follow this link to log into Applanga https://dashboard.applanga.com/#!/login
Accessing translations in the Applanga dashboard
When logging into Applanga, you will see a list of projects where you have been added to the team as a tester under “Shared Projects”. Access the project, then the language you are testing.
Every string on Applanga can have either each or both translation states: Draft in yellow (1) and Target in green (2).
Target values are translations already approved and published to the app. With the Applanga SDK integrated, that means, what’s in the Target field is currently visible to the end-users of the customer's app. As a tester you will have the “Tester/ Reviewer” user role and won’t be able to edit Target values.
Draft values are newly proposed translations either translated internally or delivered to the customer via TransPerfect translation services. If not instructed otherwise all current Draft values are in scope for testing.
You can make sure to only see all those entries with Draft values by filtering just for those entries with “Unpublished” (1) translations. In some cases, strings might have been already published prematurely and no or only a few Drafts are available. In those cases the scope should be extended to all strings in the “Needs Review” (2)
Accessing Draft translations in the test build
The Applanga Draft mode allows you to preview Draft translations directly in the app. Since you have been provided a test build of the app, you can activate the Draft mode for this app.
Open the app, press with four fingers on the screen for 8-10 secs and a pop-up will appear. Here you can log in into the Draft mode. Enter the Draft mode key that you can find in the Applanga dashboard in the project overview, top right.
After entering the Draft mode, the app will restart and now show you the Draft values that are on Applanga. Make sure your phone is set to the language that you want to test.
Here is how you can change the device language if that should be necessary.
- On iOS: https://support.apple.com/en-us/HT204031
- On Android: https://www.digitalcitizen.life/how-change-device-display-language-android
Working on Linguistic Issue with Applanga
If you encounter a linguistic issue, you can simply access the string in the Applanga editor interface and change the Draft value as you see fit. You can use the search functionality in the upper right corner to find any particular string.
To edit draft translations, simply click directly on the text, update, then click save.
Regression for Linguistic issues with Applanga
With the Applanga Draft active, whenever you completely restart the app, the translations in the app are always the latest version of the Draft values on the dashboard. You change a Draft on Applanga, you restart the app in Draft mode, the change you made will be visible in the app (after 10 minutes max).
For all linguistic issues you fixed on Applanga by editing the Draft you can immediately do a regression test simply by restarting the app in Draft mode and navigating to the affected view.
Reporting Functional Issues with Applanga
With the Applanga Jira integration, users can create Jira tickets from inside the app during the testing run (please confirm this functionality is available with the Testing manager).
When the Draft mode is enabled, swipe down with two fingers to activate the draft overlay whenever you encounter a functional issue which can’t be fixed by editing the Draft value(s) on Applanga. Press Create Issue and add a ticket title and an issue description
A Jira ticket created this way will automatically include a screenshot of the affected screen and a link to Applanga for the strings found on that screen.
On Applanga, a tag for the Jira ticket is created, the screenshot is attached to this tag and all strings found on the screen when the ticket was created are tagged accordingly (note: not all strings might be found automatically).
