---
title: Localize an iOS App with SAP Translation Hub
description: Take an iOS app generated with the SAP BTP SDK Assistant for iOS and make it multilingual with SAP Translation Hub.
auto_validation: true
primary_tag: products>ios-sdk-for-sap-btp
tags: [  tutorial>intermediate, operating-system>ios, topic>mobile, topic>odata, products>sap-business-technology-platform, products>sap-mobile-services ]
time: 15
slug: fiori-ios-scpms-custom-app-translation
canonical_url: https://developers.sap.com/tutorials/fiori-ios-scpms-custom-app-translation
---

## Prerequisites  

- **Development environment:** Apple iMac, MacBook or MacBook Pro running Xcode 10 or higher
- **SAP BTP SDK for iOS:** Version 3.0 SP01

## Details

### You will learn  

- How to enable SAP Translation Hub in your SAP BTP trial account
- How to add your SAP Translation Hub account into the SAP BTP SDK Assistant for iOS
- How to create multilingual capabilities to your Xcode project using the SAP BTP SDK Assistant for iOS
- How to modify and correct the generated translations

 In this tutorial, you will use the SAP BTP's integration with SAP Translation Hub to add multilingual features to your iOS app generated with the SAP BTP SDK Assistant for iOS. This way, you can run your app in many languages, depending on your device's preferred language.

---

[ACCORDION-BEGIN [Step 1: ](Enable SAP Translation Hub)]

Log on to your SAP BTP account at [https://account.hanatrial.ondemand.com/cockpit/](https://account.hanatrial.ondemand.com/), log in and choose Neo Trial as landscape.

In the navigation on the left select **Services**.

Locate the **SAP Translation Hub** tile (search for `translation`):

![Enable SAP Translation Hub](https://raw.githubusercontent.com/sap-tutorials/sap-btp-sdk-ios/main/tutorials/fiori-ios-scpms-custom-app-translation/fiori-ios-scpms-custom-app-translation-01.png)

If it is not yet enabled, click the tile.

In the next page, click the **Enable** button:

![Enable SAP Translation Hub](https://raw.githubusercontent.com/sap-tutorials/sap-btp-sdk-ios/main/tutorials/fiori-ios-scpms-custom-app-translation/fiori-ios-scpms-custom-app-translation-02.png)

Once the **SAP Translation Hub** service is enabled, click the **Go to UI for Translation Workflow** link at the bottom.

![Enable SAP Translation Hub](https://raw.githubusercontent.com/sap-tutorials/sap-btp-sdk-ios/main/tutorials/fiori-ios-scpms-custom-app-translation/fiori-ios-scpms-custom-app-translation-02a.png)

The **SAP Translation Hub** web interface will open in a new tab:

![Enable SAP Translation Hub](https://raw.githubusercontent.com/sap-tutorials/sap-btp-sdk-ios/main/tutorials/fiori-ios-scpms-custom-app-translation/fiori-ios-scpms-custom-app-translation-03.png)

Leave the SAP Translation Hub web interface open for now, as we will need it later.

[DONE]
[ACCORDION-END]

[ACCORDION-BEGIN [Step 2: ](Enable SAP Translation Hub in the SAP BTP SDK Assistant for iOS)]

Open the **SAP BTP SDK Assistant for iOS**. Click the **Manage Accounts** option in the lower-left corner:

![Enable SAP Translation Hub](https://raw.githubusercontent.com/sap-tutorials/sap-btp-sdk-ios/main/tutorials/fiori-ios-scpms-custom-app-translation/fiori-ios-scpms-custom-app-translation-04.png)

Click the **Add new...** button to add a new account.

![Enable SAP Translation Hub](https://raw.githubusercontent.com/sap-tutorials/sap-btp-sdk-ios/main/tutorials/fiori-ios-scpms-custom-app-translation/fiori-ios-scpms-custom-app-translation-04a.png)

From the **Type** dropdown list, select **SAP BTP Translation Hub**:

![Enable SAP Translation Hub](https://raw.githubusercontent.com/sap-tutorials/sap-btp-sdk-ios/main/tutorials/fiori-ios-scpms-custom-app-translation/fiori-ios-scpms-custom-app-translation-05.png)

Enter the following values to your new account configuration:

| Field | Value |
|----|----|
| Name | A descriptive name for the configuration, for instance `SAP Translation Hub` |
| Base URL | `https://saptranslation-<your_trial_account_user>trial.hanatrial.ondemand.com/` |
| User | Your trial account user |
| Password | Password for your trial account user |

![Enable SAP Translation Hub](https://raw.githubusercontent.com/sap-tutorials/sap-btp-sdk-ios/main/tutorials/fiori-ios-scpms-custom-app-translation/fiori-ios-scpms-custom-app-translation-06.png)

Click **Save** when done. The account is now added to the SAP BTP SDK Assistant for iOS:

![Enable SAP Translation Hub](https://raw.githubusercontent.com/sap-tutorials/sap-btp-sdk-ios/main/tutorials/fiori-ios-scpms-custom-app-translation/fiori-ios-scpms-custom-app-translation-07.png)

Go back to the main screen by clicking **Back**.

[DONE]
[ACCORDION-END]

[ACCORDION-BEGIN [Step 3: ](Add translations)]

If you don't have an application for the translation you can simple create one by adding a sample app in the **SAP BTP SDK Assistant for iOS**.

For that simply click on the **Create new** button on the initial screen.

![Add Sample App](https://raw.githubusercontent.com/sap-tutorials/sap-btp-sdk-ios/main/tutorials/fiori-ios-scpms-custom-app-translation/fiori-ios-scpms-custom-app-translation-create-app-1.png)

Next select the **Sample App** tile to go to the creation process.

![Add Sample App](https://raw.githubusercontent.com/sap-tutorials/sap-btp-sdk-ios/main/tutorials/fiori-ios-scpms-custom-app-translation/fiori-ios-scpms-custom-app-translation-create-app-2.png)

Make sure your Mobile Services account is selected and click on **Next**.

![Add Sample App](https://raw.githubusercontent.com/sap-tutorials/sap-btp-sdk-ios/main/tutorials/fiori-ios-scpms-custom-app-translation/fiori-ios-scpms-custom-app-translation-create-app-3.png)

Now the assistant will ask you to add an SAP Mobile Services application. You can fill out the fields as you wish.

![Add Sample App](https://raw.githubusercontent.com/sap-tutorials/sap-btp-sdk-ios/main/tutorials/fiori-ios-scpms-custom-app-translation/fiori-ios-scpms-custom-app-translation-create-app-4.png)

The last step is to create the Xcode project. Fill out the fields as you wish.

![Add Sample App](https://raw.githubusercontent.com/sap-tutorials/sap-btp-sdk-ios/main/tutorials/fiori-ios-scpms-custom-app-translation/fiori-ios-scpms-custom-app-translation-create-app-5.png)

The project you just created is a fully functional iOS app connected against one of our sample services. After the creation you will see the project in the **Recent Projects** list on the initial screen. If you click on **All Projects** you will get an overview of all your projects.

![Add Sample App](https://raw.githubusercontent.com/sap-tutorials/sap-btp-sdk-ios/main/tutorials/fiori-ios-scpms-custom-app-translation/fiori-ios-scpms-custom-app-translation-create-app-6.png)

On the **Manage Screen** click on **Translate** under the **Add Translation** part on the right side.

![Add translations](https://raw.githubusercontent.com/sap-tutorials/sap-btp-sdk-ios/main/tutorials/fiori-ios-scpms-custom-app-translation/fiori-ios-scpms-custom-app-translation-08.png)

[DONE]
[ACCORDION-END]

[ACCORDION-BEGIN [Step 4: ](Add translation to your project)]

Now we will go through the translation flow to add localization to our app.

First select the previously added **Translation Hub account** and click on **Next**.

![Add translations](https://raw.githubusercontent.com/sap-tutorials/sap-btp-sdk-ios/main/tutorials/fiori-ios-scpms-custom-app-translation/fiori-ios-scpms-custom-app-translation-09.png)

The Translation Hub doesn't have a project yet so click on **Add new** to create one.

![Add translations](https://raw.githubusercontent.com/sap-tutorials/sap-btp-sdk-ios/main/tutorials/fiori-ios-scpms-custom-app-translation/fiori-ios-scpms-custom-app-translation-10.png)

For the **Translation Hub Project Details** enter a **Project Name** and select the languages you want to translate to. Click on **Save**.

![Add translations](https://raw.githubusercontent.com/sap-tutorials/sap-btp-sdk-ios/main/tutorials/fiori-ios-scpms-custom-app-translation/fiori-ios-scpms-custom-app-translation-10a.png)

You will see now the created Translation Hub project. Select it and click on **Finish**.

![Add translations](https://raw.githubusercontent.com/sap-tutorials/sap-btp-sdk-ios/main/tutorials/fiori-ios-scpms-custom-app-translation/fiori-ios-scpms-custom-app-translation-10b.png)

[DONE]
[ACCORDION-END]

[ACCORDION-BEGIN [Step 5: ](Examine the updated Xcode project)]

Open the Xcode project for your app. Notice the added `InfoPlist.strings` and `Localizable.strings` files for the languages you have selected for translation:

![Add translations](https://raw.githubusercontent.com/sap-tutorials/sap-btp-sdk-ios/main/tutorials/fiori-ios-scpms-custom-app-translation/fiori-ios-scpms-custom-app-translation-11.png)

If you run the app now, and change the simulators language to one of the languages you translated to, you will see the strings have changed. It can happen that some of the translations are not 100% correct. You can fix that relatively easy by changing the values in the `Localizable.strings` file or you can do it in the **SAP Translation Hub**.

![Add translations](https://raw.githubusercontent.com/sap-tutorials/sap-btp-sdk-ios/main/tutorials/fiori-ios-scpms-custom-app-translation/fiori-ios-scpms-custom-app-translation-11a.png)

[DONE]
[ACCORDION-END]

[ACCORDION-BEGIN [Step 6: ](Modify the generated translations)]

Go back to your cloud account and make sure you're on the Neo landscape.

Navigate to **Services > SAP Translation Hub** in your SAP BTP trial account and click the **Go to UI for Translation Workflow** link. The **SAP Translation Hub** web interface will open in a new tab. you will now see the just added `MySampleApp` project:

![Add translations](https://raw.githubusercontent.com/sap-tutorials/sap-btp-sdk-ios/main/tutorials/fiori-ios-scpms-custom-app-translation/fiori-ios-scpms-custom-app-translation-12.png)

Click on the **Translations** tab. On this page, an overview of the original texts and the translated texts for the selected languages are shown:

![Add translations](https://raw.githubusercontent.com/sap-tutorials/sap-btp-sdk-ios/main/tutorials/fiori-ios-scpms-custom-app-translation/fiori-ios-scpms-custom-app-translation-13.png)

Here you can correct any translations that may be incorrect, and click the **Save Project** button once done.

[DONE]
[ACCORDION-END]

[ACCORDION-BEGIN [Step 7: ](Re-import the modified translations)]

If you changed some of the translations in the **SAP Translation Hub** you have to run the translation out of the **SAP BTP SDK Assistant for iOS** again.
To do so go back to the **All Projects**, select the project for localization and click on **Translate**.

After finishing up the process the service should have updated the localized Strings in your Xcode project.

[DONE]
[ACCORDION-END]

[ACCORDION-BEGIN [Step 8: ](Localize the app name)]

If you go back to Xcode you will see `"CFBundleName" = "$(PRODUCT_NAME)";` in the `InfoPlist.strings` file. This will help choose the correct translation of your app's name. It is necessary to translate the app's name manually, so we need to add translations for that.

Each of the `InfoPlist.strings` files represent one of the languages. Go in each of them and change the `"$(PRODUCT_NAME)"` to a proper bundle name also add the following line of code right below it:

```swift

"CFBundleDisplayName" = "Your translated application name";
```

![Add translations](https://raw.githubusercontent.com/sap-tutorials/sap-btp-sdk-ios/main/tutorials/fiori-ios-scpms-custom-app-translation/fiori-ios-scpms-custom-app-translation-13a.png)

If you run the app now you should see the value you entered:

![Add translations](https://raw.githubusercontent.com/sap-tutorials/sap-btp-sdk-ios/main/tutorials/fiori-ios-scpms-custom-app-translation/fiori-ios-scpms-custom-app-translation-13b.png)

[VALIDATE_8]
[ACCORDION-END]

---