Uploading Screenshots via an Integration

How to Capture and Upload Screenshots to the Applanga Dashboard using an Integration

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

  1. Draft Mode
  2. API Screenshot Upload
  3. Applanga Design Plugin
  4. Automated UI Tests

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

For the Draft Mode option:

  1. Open the app in Draft Mode (press with four fingers on the screen for 8-10 secs and login using the Applanga username and password)
  2. Navigate to the screen that needs a screenshot upload
  3. Swipe down with two fingers on the screen. A button and a dropdown menu will appear.
  4. From the Drop Down, choose the appropriate Tag or create a new tag to add the screenshot and click the button to capture the screenshot
  5. Repeat for every screen/Tag which needs a screenshot upload

See the Draft Mode and On-Device Testing page for more details about the Applanga Draft Mode.

Back to Top

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.

  1. 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.
  2. 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.

Back to Top

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.

Back to Top

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:

Back to Top