Login Start for Free

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. Automated UI Tests for Native Mobile Apps
  3. Appium
  4. API Screenshot Upload
  5. Applanga Design Plugin

On Applanga, regular screenshots can be turned into Augmented Screenshots to provide even more context for translators and reviewers. Augmented 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
  • Appium: Via the Applanga SDK or CLI Integrations
  • API: Screenshot and metadata upload via API
  • Figma/Sketch/AdobeXD: Via an Applanga Design Plugin

Screens uploaded via the Applanga SDK, Appium, or design plugins 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.

  1. 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)
  2. Navigate to the screen that needs a screenshot upload
  3. Swipe down with two fingers on the screen, then select Capture Screen.
  4. Select Select existing screen tag to use an existing tag from Applanga OR type a new one in the textbox below.
  5. Press Capture.
  6. 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.


Back to Top


Automated UI Tests for Native Mobile Apps

If an app already has native 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


Appium

The Appium screenshot capture and upload is only available for SDK or CLI-integrated apps. By integrating Appium and Applanga, the process can be streamlined. Users can re-leverage their existing Appium test scripts to upload screenshots to the connected Applanga project.

See the Appium example projects on GitHub to learn more or see the Applanga-Appium repo to get started.


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 route.

  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 Tool Plugin users can easily upload base language screens, translate within the Applanga dashboard, then download translated strings to generate translated screenshots.


Back to Top