Merge pull request #37 from Microsoft/bugfix/client-building

Add troubleshooting steps for building mobile client

Author: momohs

MobileClient/README.md

@@ -36,7 +36,7 @@ Ensure that you have the Android SDK downloaded
 To download the native plugins and setup the cordova android project run:
 
 ``` Bash
-ionic cordova platform add android
+ionic cordova platform add android@6.4.0
 ```
 
 #### Android Build and run
@@ -53,6 +53,24 @@ To run the application on a device or emulator:
 ionic cordova run android
 ```
 
+#### Android troubleshooting
+
+In some environments, building fresh clones may fail with the errors:
+
+``` Bash
+ERROR: In <declare-styleable> FontFamilyFont, unable to find attribute android:fontVariationSettings
+ERROR: In <declare-styleable> FontFamilyFont, unable to find attribute android:ttcIndex
+```
+
+To solve these issues, go to the `plugin/` directory, search for "com.android.support:support-v4:+" and replace it with "com.android.support:support-v4:27.1.0".
+
+Then remove and add the Android platform directory using the commands:
+
+``` Bash
+ionic cordova platform remove android
+ionic cordova platform add [email protected]
+```
+
 ### iOS
 
 #### iOS Prerequisites

MobileClient/config.xml

@@ -73,7 +73,6 @@
         <param name="ios-package" onload="true" value="CDVStatusBar" />
     </feature>
     <allow-navigation href="http://10.104.242.8:8100" />
-    <engine name="android" spec="~6.3.0" />
     <plugin name="ionic-plugin-keyboard" spec="^2.2.1" />
     <plugin name="cordova-plugin-whitelist" spec="^1.3.1" />
     <plugin name="cordova-plugin-console" spec="^1.0.5" />
@@ -91,4 +90,5 @@
         <variable name="ALWAYS_USAGE_DESCRIPTION" value="This app requires background tracking enabled" />
         <variable name="MOTION_USAGE_DESCRIPTION" value="This app requires motion detection" />
     </plugin>
+    <engine name="android" spec="6.4.0" />
 </widget>