Upgraded Appium, NS, and NS-vue versions, fixed bugs, completed docs

README.md

@@ -3,20 +3,59 @@ This project uses Appium to test Vue UI components, and also serves as a source
 component screenshots at [nativescript-vue.org](https://nativescript-vue.org/).
 
 ## System requirements
+
 * Node 7.6 or higher (for async function support).
-* The [Appium](http://appium.io/) client. Just download and install the latest [from GitHub](https://github.com/appium/appium-desktop/releases/latest).
+* The [Appium](http://appium.io/) client. Just download and install the latest [from GitHub](https://github.com/appium/appium-desktop/releases/latest) or execute the following command:
+
+```bash
+npm install -g appium
+```
+
+### iOS requirements
+
+* Carthage:
+
+```bash
+brew install carthage
+````
 
 ## Running the tests locally
-Start Appium and press 'Start the server', or you'll receive an error `127.0.0.1:4723` can't be reached.
+
+Start Appium, which is
+
+* Using the desktop app, press 'Start the server'
+* Using the NPM package, execute `appium` on a terminal
+
+Otherwise you'll receive an error `127.0.0.1:4723` can't be reached.
 
 ### Android
+
+Edit the `appium.capabilities.json` config file, in the `android23` section, with your device/emulators parameters, probably only the `avd` or `deviceName` parameters would be enough.
+
+Start the tests:
+
 ```bash
 npm run android.build
+adb install ./platforms/android/app/build/outputs/apk/debug/app-debug.apk
 npm run android.screenshots
 ```
 
 ### iOS
+
+Edit the `appium.capabilities.json` config file, in the `ios-simulator103iPhone6` section, with your device/emulators parameters.
+
+Build the iOS app
+
 ```bash
 npm run ios.build
+```
+
+Start `XCode` and open the `platforms/ios/nativescriptvueuitests.xcodeproj` file.
+
+Run the app on the emulator. This is needed in order to have the app installed.
+
+Run the tests:
+
+```bash
 npm run ios.screenshots
 ```

app/app.js

@@ -110,11 +110,13 @@ new Vue({
     },
 
     template: `
+    <Frame>
         <Page>
             <ActionBar title="Home"></ActionBar>
             <WrapLayout class="m-5 home-list">
                 <Button :text="el.name" v-for="el in elements" @tap="showElement(el)" />
             </WrapLayout>
         </Page>
+    </Frame>
     `,
 }).$start();

appium.capabilities.json

@@ -1,17 +1,20 @@
 {
   "android23": {
+    "automationName": "appium",
     "platformName": "Android",
     "platformVersion": "6.0",
     "deviceName": "Android Emulator",
     "noReset": false,
+    "avd": "Nexus_5X_API_27",
     "appPackage": "org.nativescript.nativescriptvueuitests",
     "appActivity": "com.tns.NativeScriptActivity"
   },
   "ios-simulator103iPhone6": {
+    "automationName": "appium",
     "platformName": "iOS",
-    "platformVersion": "10.3",
+    "platformVersion": "11.4",
     "deviceName": "iPhone Simulator",
     "bundleId": "org.nativescript.nativescriptvueuitests",
     "app": ""
   }
-}
+}

generate-screenshots.js

@@ -1,5 +1,6 @@
 const argv = require('yargs').argv;
 const AppiumDriver = require('nativescript-dev-appium').AppiumDriver;
+const DeviceManager = require('nativescript-dev-appium').DeviceManager;
 const fs = require('fs');
 
 const components = [
@@ -39,13 +40,23 @@ const makeDir = (path) => {
     makeDir('screenshots');
     makeDir(`screenshots/${argv.runType}`);
 
-    AppiumDriver.createAppiumDriver(4723, {
-        isSauceLab: argv.sauceLab || false,
-        runType: argv.runType,
-        appPath: argv.appPath, //'nativescriptvueuitests-debug.apk',
-        appiumCaps: require('./appium.capabilities.json')[argv.runType],
-        verbose: argv.verbose || false,
-    })
+    const appiumCaps = require('./appium.capabilities.json')[argv.runType];
+    let args = {
+      isSauceLab: argv.sauceLab || false,
+      runType: argv.runType,
+      appPath: argv.appPath, //'nativescriptvueuitests-debug.apk',
+      appiumCaps: appiumCaps,
+      verbose: argv.verbose || false,
+    }
+    // Hack to fix a `Cannot read property 'token' of undefined` error
+    // See https://github.com/NativeScript/nativescript-dev-appium/issues/142
+    if (args.isAndroid) {
+        args.device = DeviceManager.getDefaultDevice(args, appiumCaps.avd);
+    } else {
+        args.device = DeviceManager.getDefaultDevice(args);
+    }
+
+    AppiumDriver.createAppiumDriver(4723, args)
         .then(driver => run(driver))
         .then(() => console.log('Buh-Bye...'))
         .catch((err) => console.log(err));

package.json

@@ -6,17 +6,17 @@
   "nativescript": {
     "id": "org.nativescript.nativescriptvueuitests",
     "tns-ios": {
-      "version": "3.4.1"
+      "version": "4.1.0"
     },
     "tns-android": {
-      "version": "3.4.1"
+      "version": "4.1.3"
     }
   },
   "dependencies": {
-    "appium": "^1.7.1",
-    "nativescript-dev-appium": "^3.1.0-2017-10-6-1",
-    "nativescript-vue": "^1.0.0",
-    "tns-core-modules": "~3.4.0",
+    "appium": "^1.8.1",
+    "nativescript-dev-appium": "^4.0.0",
+    "nativescript-vue": "^2.0.0-alpha.1",
+    "tns-core-modules": "^4.1.1",
     "yargs": "^9.0.1"
   },
   "scripts": {
@@ -34,6 +34,9 @@
     "babel-traverse": "6.26.0",
     "babel-types": "6.26.0",
     "babylon": "6.18.0",
-    "lazy": "1.0.11"
+    "lazy": "1.0.11",
+    "@types/chai": "^4.0.2",
+    "@types/mocha": "^2.2.41",
+    "@types/node": "^7.0.5"
   }
 }