How to Install

  • Download the DMG file
  • Quit Xcode
  • Check this folder exists, if not, create it: ~/Library/Application Support/Developer/Shared/Xcode/Plug-ins
  • Open the DMG File
  • Drag the Rephrase.xcplugin to the Plug-Ins Folder
  • Open Xcode

Install the plug-in from the DMG

How it works

The Rephrase plug-in scans your project for .strings files, every-time you make a request for a localisation, it requests for each locale you have. You don't have to tell it.

How to use

Find some text to localise

Look for a string in your code that you want to localise

Select the text

Select the text you wish to localise

Right click and select Localise

Right click and select the localise option from the menu that appears

Searching for Localisations

Rephrase will now check and see if it already has a localisation for that value in it's database.

Localisation Found

If localisations are found, they are presented in a list

Localisation Selection

You can pick the correct context from the list - double click

Code is automatically changed

The plug-in automatically changes your source code

...and updates your localizable.strings files

When localisations aren't found

If we can't find a localisation for that value, enter some context and click ok to request localisation. We ask for context as it helps the translator understand what you are saying.

Rephrase Settings

You can get to the Rephrase settings screen by going to Window->Rephrase Settings menu

Settings Details

If you are a licensee, you can enter your licence number in the licence key box. You can also refresh localisations for your entire project from this panel.

Refreshing your localisations

You can also refresh your localisations from the Edit->Refresh Localisations menu

Uninstalling

  • Quit Xcode
  • Go to: ~/Library/Application Support/Developer/Shared/Xcode/Plug-ins
  • Delete: Rephrase.xcplugin
  • Optionally, Restart Xcode

System Requirements

  • Mac OSX Yosemite 10.10+
  • Xcode 6.1+

Trouble Shooting

After installing the Plugin, Xcode fails to launch

Uninstall the plugin and see if Xcode starts without the plugin. If it does, then it appears there must be a conflict with the plugin and your version of Xcode. If a crash report was generated, please send it to us at contact@rephrase.io.