This article will show users how to automatically upload screenshots to the Applanga dashboard. To learn how to upload new or edit existing screenshots manually see the Uploading & Editing Screenshots documentation.
Table of Contents
On Applanga, regular screenshots can be turned into Smart Screenshots to provide even more context for translators and reviewers. Smart Screenshots are a combination of the screenshot itself with a specific set of metadata that informs Applanga about which strings are present on a screen as well as the string’s position.
The main ways to upload screenshots via an integration include:
- SDK: Via the Draft Mode upload option
- SDK: Via automated UI tests
- API: Screenshot and metadata upload via API
- Figma/Sketch/AdobeXD: Via an Applanga Design Plugin
Screens uploaded via the Applanga SDK or design plugin automatically capture the string/screen pairing and the string’s position. For screens uploaded via the API, users can send the metadata of the screen association (tag) and string positions along with the upload call.
Draft Mode
Draft Mode must be enabled in the Project Settings page in order to use this option.
- Open the app in Draft Mode (press with four fingers on the screen for 8-10 secs and login using your Applanga username and password)
- Navigate to the screen that needs a screenshot upload
- Swipe down with two fingers on the screen, then select Capture Screen.
- Select Select existing screen tag to use an existing tag from Applanga OR type a new one in the textbox below.
- Press Capture.
- Repeat for every screen/Tag which requires a screenshot upload
See the Draft Mode and On-Device Testing page for more details about the Applanga Draft Mode.
Automated UI Tests
If an app already has automated UI tests, users can simply add one line of code to the test scripts at the point where screenshots uploads are needed.
Follow the instructions outlined in the integration documentation to implement this option:
API Screenshot Upload
This option is only available for Applanga API integrated apps. See the Applanga API documentation for additional details. The API screenshot upload process allows Applanga users to send the string position as metadata along with the screenshot upload API call.
- Users must first send a GET request to the Applanga API. This will identify the App, authenticate the token, and return all the screenshots of the App.
- Then send a POST request with a FormData containing two keys: data and file. The screenshot will be uploaded to the app and a JSON object describing the changes will be returned.
Applanga Design Plugin
This option is only available to users with an Adobe XD, Figma, or Sketch integrated project using the Applanga plugin. See the Localization at the Design Stage article and the Adobe XD, Figma, or Sketch Documentation for more information.
The Applanga design plugin will import the strings as well as the strings’ position for each screen. Applanga Design Plugin users can easily upload base language screens, translate within the Applanga dashboard, then download translated strings to generate translated screens.