Publish translation updates to iOS, Android and Flutter apps effortlessly with Phrase Over the Air (OTA).
Phrase lets you update translations for your iOS, Android and Flutter applications with a single click. No need to release a new version to the App Store or Google Play. Phrase lets you push updates for text labels in your mobile apps instantly:
Install the appropriate SDK to connect your app with Phrase:
Get started with Phrase Over the Air by creating your first distribution. Within a distribution you can define the target platforms (i.e. iOS, Android, Flutter). You can have multiple distributions but typically you will have one distribution per project. If you are using a distribution for iOS and Android, our placeholder conversion will convert placeholders between the two formats automatically.
To create a distribution, simply visit the Integrations section via the blue navigation bar at the top of your account dashboard. You can now see that Over the Air (OTA) is listed as the second entry of the entire integrations list. Simply click on Configure to access the OTA overview page. Alternatively, you can go there directly via the Over the Air tab in your account navigation bar. If you haven't created a distribution yet, this would look something like this.
Here you can create your distributions and later access and manage each of them. Click Create Distribution and enter the required information.
For an Android distribution you can toggle the format option that encloses any translation including HTML tags in CDATA.
Under Settings you also have the option to select some fallback scenarios and also enforce that only reviewed versions of translations are included, see Advanced Review Workflow.
Clicking on Save will automatically lead you to the overview page of this distribution, where you can find the respective Distribution ID as well as development and production secret. Use the distribution ID and the specific environment secret to address a distribution within the SDK.
To update translations, simply create a new release within the distribution. This will export the current state of your project and make it available to the connected clients. For each release you can specify:
- Environment: Decide whether the release is for development only or should be pushed to production
- Version range: Define which version of your app should receive the update
- Platform: Publish an update to either Android, iOS, Flutter or all three (presumed that you have a distribution with the respective platforms activated)
Can I use Phrase Over the Air on-premise?
For the time being, this is not possible. We will keep you informed as soon as we're working on it. Please contact us for further information on Over the Air on-premise.
What platforms do you support?
Phrase Over the Air currently supports delivering translations to iOS, Android and Flutter. If you want to use it with other platforms and formats, please contact us.
Can I use Phrase Over the Air directly with frameworks like, React Native and Ionic?
Not yet! At this time, the Phrase Over the Air SDKs are only available for iOS, Android and Flutter apps.
Do you collect usage metrics?
We do collect certain metrics to calculate the usage of the feature. Just have a look at this article.
What constitutes a Monthly Active User (MAU)?
When a user starts an application implementing our iOS, Android or Flutter SDK for the first time on a device, we generate a unique, random Device Identifier. This identifier's sole purpose is the tracking of active users over a given period of time. It is not used for any other form or means of tracking and does not contain any user or device information.
Each Phrase plan allows for a certain amount of Monthly Active Users (MAU), this is the total number of unique Device Identifiers that query our servers in a given month.
If you need a custom quota, please get in touch with our Sales team on firstname.lastname@example.org.
Also, we will not automatically lock your account/OTA functionality when you exceed your MAU quota, but instead reach out to explore options going forward.
Why are changes in my distribution settings are not reflected in the current release?
You need to create a new release in order for the updated settings to be applied.
Does OTA work per language?
With Over the Air distributions you're releasing a snapshot of the project you configured it for. However, if your workflow requires finishing up on a language and release it before the other languages in your project are ready, you can make use of our Branching feature.
By indicating a specific source branch for every release enables you to basically proceed language by language. In general terms, we'd recommend having the entire project release-ready.
Is there a limit for the amount of releases I can create?
No. The only limit regarding OTA is the amount of MAU (monthly active users), depending on which pricing plans you have chosen.