Document how to add locales in the Xcode project.

This commit is contained in:
Ognen Ivanovski 2016-03-04 22:29:08 +01:00
parent f7f72e1d8a
commit a62db8e25b
2 changed files with 15 additions and 4 deletions

View File

@ -1,4 +1,4 @@
<img src="https://cdn0.iconfinder.com/data/icons/material-design-ii-glyph/614/3010_-_Translate-512.png" width="110" align="left"> <img src="https://cdn0.iconfinder.com/data/icons/material-design-ii-glyph/614/3010_-_Translate-512.png" width="110" align="left">
# react-native-i18n # react-native-i18n
Integrates [I18n.js](https://github.com/fnando/i18n-js) with React Native. Uses the device's locale as default. Integrates [I18n.js](https://github.com/fnando/i18n-js) with React Native. Uses the device's locale as default.
<br/> <br/>
@ -7,7 +7,7 @@ Integrates [I18n.js](https://github.com/fnando/i18n-js) with React Native. Uses
## Installation ## Installation
If you're on react-native >= 0.40: `$ npm install react-native-i18n --save` If you're on react-native >= 0.40: `$ npm install react-native-i18n --save`
If you're on react-native < 0.40: `$ npm install react-native-i18n@0.1.1 --save` If you're on react-native < 0.40: `$ npm install react-native-i18n@0.1.1 --save`
## Automatic setup ## Automatic setup
After installing the npm package you need to link the native modules. After installing the npm package you need to link the native modules.
If you're using React-Native < 0.29 install [rnpm](https://github.com/rnpm/rnpm) with the command `npm install -g rnpm` and then link the library with the command `rnpm link`. If you're using React-Native < 0.29 install [rnpm](https://github.com/rnpm/rnpm) with the command `npm install -g rnpm` and then link the library with the command `rnpm link`.
@ -18,11 +18,22 @@ If you're having any issue you can also try to install the library manually as f
**[WARNING]** There is currently [an issue](https://github.com/AlexanderZaytsev/react-native-i18n/issues/43) with the react-native link / rnpm install method. Prefers the manual install until it is solved. **[WARNING]** There is currently [an issue](https://github.com/AlexanderZaytsev/react-native-i18n/issues/43) with the react-native link / rnpm install method. Prefers the manual install until it is solved.
## Manual setup ## Manual setup
### iOS ### iOS
Add `RNI18n.xcodeproj` to **Libraries** and add `libRNI18n.a` to **Link Binary With Libraries** under **Build Phases**. Add `RNI18n.xcodeproj` to **Libraries** and add `libRNI18n.a` to **Link Binary With Libraries** under **Build Phases**.
[More info and screenshots about how to do this is available in the React Native documentation](http://facebook.github.io/react-native/docs/linking-libraries-ios.html#content). [More info and screenshots about how to do this is available in the React Native documentation](http://facebook.github.io/react-native/docs/linking-libraries-ios.html#content).
You also need to add the **localizations** you intend to support to the iOS project. To do that open
your Xcode project:
```
$ open <your-project>.xcodeproj
```
and add the localizations you will support as shown here:
![adding locales](docs/adding-locales.png)
### Android ### Android
Add `react-native-i18n` to your `./android/settings.gradle` file as follows: Add `react-native-i18n` to your `./android/settings.gradle` file as follows:
``` ```
@ -51,7 +62,7 @@ protected List<ReactPackage> getPackages() {
... ...
new ReactNativeI18n(), // <-- Add it to the packages list new ReactNativeI18n(), // <-- Add it to the packages list
... ...
); );
} }
... ...

BIN
docs/adding-locales.png Normal file

Binary file not shown.

After

Width:  |  Height:  |  Size: 261 KiB