Getting Started Guide - Xcode
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
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.