<NME> README.md
<BEF> # Rocket.Chat.Cordova
Rocket.Chat Cross-Platform Mobile Application via Cordova

# DEPRECATED
As of March (3/18) this application has been deprecated and is no longer maintained. 

Please see our native mobile apps:
- iOS - [here](https://github.com/RocketChat/Rocket.Chat.iOS)
- Android - [here](https://github.com/RocketChat/Rocket.Chat.Android)

Both apps can be found in their respective app stores by searching for: `Rocket.Chat`

Cordova app will not be able to connect to Rocket.Chat server 0.72.0 and higher as support has been removed.



### Development

#### Requirements
 * npm
 * nodejs 0.12
 * ImageMagick (with support for legacy utilities)

#### Install dependencies
```shell
sudo npm install cordova coffee-script -g
npm install
```

### Create Conf files
```
echo 'Bugsnag.apiKey = "YOUR-API-KEY-HERE";' > www/js/bugsnag_apikey.js
echo 'window.ANDROID_SENDER_ID = "YOUR-ANDROID-ID-HERE";' > www/shared/js/android_sender_id.js
```


#### Prepare - Install platforms and plugins
```shell
cordova prepare
```

#### Run on emulator
```shell
cordova emulate ios
```
or
```shell
cordova emulate android
```

#### Run on device
```shell
cordova run ios --device
```
or
```shell
cordova run android --device
```

#### Troubleshooting

Some have had issues with a couple of dependencies not being installed by npm.
Running: `npm install ticons underscore` may be necessary.

## I can't connect to my server instance
If you are running your server using the command `meteor` you should define the URL where the mobile application will try to connect `meteor --mobile-server http://192.168.1.10:3000`, replace **http://192.168.1.10:3000** by your IP or domain.

This is necessary because the mobile application download all files to run locally and then start the connection with your server, as you are running as develop mode this is necessary.


## Assets
- `1024 x 1024` **icon-android.png** (can use transparent background)
- `1024 x 1024` **icon-ios.png**
- `2208 x 2208` **splash-android.png**
- `2208 x 2208` **splash-ipad.png**
- `2208 x 2208` **splash-iphone.png**

Examples https://github.com/RocketChat/Rocket.Chat.Cordova/tree/develop/assets

<MSG> Merge branch 'develop' into add-deprecation
<DFF> @@ -33,7 +33,6 @@ echo 'Bugsnag.apiKey = "YOUR-API-KEY-HERE";' > www/js/bugsnag_apikey.js
 echo 'window.ANDROID_SENDER_ID = "YOUR-ANDROID-ID-HERE";' > www/shared/js/android_sender_id.js
 ```
 
-
 #### Prepare - Install platforms and plugins
 ```shell
 cordova prepare

{'commit': 'diff --git a/README.md b/README.md\nindex a9f42b0..7fd6bd9 100644\n--- a/README.md\n+++ b/README.md\n@@ -33,7 +33,6 @@ echo \'Bugsnag.apiKey = "YOUR-API-KEY-HERE";\' > www/js/bugsnag_apikey.js\n echo \'window.ANDROID_SENDER_ID = "YOUR-ANDROID-ID-HERE";\' > www/shared/js/android_sender_id.js\n ```\n \n-\n #### Prepare - Install platforms and plugins\n ```shell\n cordova prepare\n', 'commit_subject': "Merge branch 'develop' into add-deprecation", 'repo_name': 'RocketChat/Rocket.Chat.Cordova', 'committer': {'name': 'GitHub', 'email': '1505422b2465e9a84f6fdfaa161078890c593f06@github.com', 'time_sec': '1541029294', 'tz_offset': '-300', 'date': {'seconds': '1541029294'}}, 'commit_tree': '712f832b5ce5bc408f2ac90c50198369f47fda00', 'commit_message': "Merge branch 'develop' into add-deprecation", 'language_name': 'JavaScript', 'license': 'mit', 'hunks': '@@ -33,7 +33,6 @@ echo \'Bugsnag.apiKey = "YOUR-API-KEY-HERE";\' > www/js/bugsnag_apikey.js\n echo \'window.ANDROID_SENDER_ID = "YOUR-ANDROID-ID-HERE";\' > www/shared/js/android_sender_id.js\n ```\n \n-\n #### Prepare - Install platforms and plugins\n ```shell\n cordova prepare\n', 'addition_count': 0, 'deletion_count': 1, 'src_file': 'a/README.md', 'tgt_file': 'b/README.md', 'file_extension': '.md', 'before_file': '# Rocket.Chat.Cordova\nRocket.Chat Cross-Platform Mobile Application via Cordova\n\n# DEPRECATED\nAs of March (3/18) this application has been deprecated and is no longer maintained. \n\nPlease see our native mobile apps:\n- iOS - [here](https://github.com/RocketChat/Rocket.Chat.iOS)\n- Android - [here](https://github.com/RocketChat/Rocket.Chat.Android)\n\nBoth apps can be found in their respective app stores by searching for: `Rocket.Chat`\n\nCordova app will not be able to connect to Rocket.Chat server 0.72.0 and higher as support has been removed.\n\n\n\n### Development\n\n#### Requirements\n * npm\n * nodejs 0.12\n * ImageMagick (with support for legacy utilities)\n\n#### Install dependencies\n```shell\nsudo npm install cordova coffee-script -g\nnpm install\n```\n\n### Create Conf files\n```\necho \'Bugsnag.apiKey = "YOUR-API-KEY-HERE";\' > www/js/bugsnag_apikey.js\necho \'window.ANDROID_SENDER_ID = "YOUR-ANDROID-ID-HERE";\' > www/shared/js/android_sender_id.js\n```\n\n\n#### Prepare - Install platforms and plugins\n```shell\ncordova prepare\n```\n\n#### Run on emulator\n```shell\ncordova emulate ios\n```\nor\n```shell\ncordova emulate android\n```\n\n#### Run on device\n```shell\ncordova run ios --device\n```\nor\n```shell\ncordova run android --device\n```\n\n#### Troubleshooting\n\nSome have had issues with a couple of dependencies not being installed by npm.\nRunning: `npm install ticons underscore` may be necessary.\n\n## I can\'t connect to my server instance\nIf you are running your server using the command `meteor` you should define the URL where the mobile application will try to connect `meteor --mobile-server http://192.168.1.10:3000`, replace **http://192.168.1.10:3000** by your IP or domain.\n\nThis is necessary because the mobile application download all files to run locally and then start the connection with your server, as you are running as develop mode this is necessary.\n\n\n## Assets\n- `1024 x 1024` **icon-android.png** (can use transparent background)\n- `1024 x 1024` **icon-ios.png**\n- `2208 x 2208` **splash-android.png**\n- `2208 x 2208` **splash-ipad.png**\n- `2208 x 2208` **splash-iphone.png**\n\nExamples https://github.com/RocketChat/Rocket.Chat.Cordova/tree/develop/assets\n', 'message': "Merge branch 'develop' into add-deprecation", 'author_name': 'GitHub', 'lang': 'md'}