2013-05-29 04:43:38 +08:00
|
|
|
<!--
|
|
|
|
|
#
|
|
|
|
|
# Licensed to the Apache Software Foundation (ASF) under one
|
|
|
|
|
# or more contributor license agreements. See the NOTICE file
|
|
|
|
|
# distributed with this work for additional information
|
|
|
|
|
# regarding copyright ownership. The ASF licenses this file
|
|
|
|
|
# to you under the Apache License, Version 2.0 (the
|
|
|
|
|
# "License"); you may not use this file except in compliance
|
|
|
|
|
# with the License. You may obtain a copy of the License at
|
2015-01-21 02:58:58 +08:00
|
|
|
#
|
2013-05-29 04:43:38 +08:00
|
|
|
# http://www.apache.org/licenses/LICENSE-2.0
|
2015-01-21 02:58:58 +08:00
|
|
|
#
|
2013-05-29 04:43:38 +08:00
|
|
|
# Unless required by applicable law or agreed to in writing,
|
|
|
|
|
# software distributed under the License is distributed on an
|
|
|
|
|
# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
|
|
|
|
|
# KIND, either express or implied. See the License for the
|
|
|
|
|
# specific language governing permissions and limitations
|
|
|
|
|
# under the License.
|
|
|
|
|
#
|
|
|
|
|
-->
|
2015-01-21 02:58:58 +08:00
|
|
|
# Android Native Tests
|
2012-03-31 00:37:29 +08:00
|
|
|
|
|
|
|
|
These tests are designed to verify Android native features and other Android specific features.
|
2015-01-21 02:58:58 +08:00
|
|
|
|
|
|
|
|
## Initial Setup
|
|
|
|
|
|
|
|
|
|
### Setting env vars
|
|
|
|
|
|
|
|
|
|
Run:
|
|
|
|
|
|
|
|
|
|
../bin/check_reqs
|
|
|
|
|
|
|
|
|
|
Use the output to set your `ANDROID_HOME` and `JAVA_HOME` environment variables.
|
|
|
|
|
|
|
|
|
|
### Adding `gradlew`
|
|
|
|
|
|
|
|
|
|
Copy it from a freshly created project:
|
|
|
|
|
|
|
|
|
|
../bin/create foo
|
|
|
|
|
(cd foo && cordova/build --gradle; cp -r gradlew gradle ..)
|
|
|
|
|
rm -r foo
|
2012-03-31 00:37:29 +08:00
|
|
|
|
2015-01-21 02:58:58 +08:00
|
|
|
## Running
|
2012-03-31 00:37:29 +08:00
|
|
|
|
2015-01-21 02:58:58 +08:00
|
|
|
To run manual tests:
|
2012-03-31 00:37:29 +08:00
|
|
|
|
2015-01-21 02:58:58 +08:00
|
|
|
./gradlew installDebug
|
2012-03-31 00:37:29 +08:00
|
|
|
|
2015-01-21 02:58:58 +08:00
|
|
|
To run unit tests:
|
2012-06-01 07:01:20 +08:00
|
|
|
|
2015-01-21 02:58:58 +08:00
|
|
|
./gradlew connectedAndroidTest
|
2012-06-01 07:01:20 +08:00
|
|
|
|
2015-04-07 21:52:12 +08:00
|
|
|
`BUILD SUCCESSFUL` means that the tests all passed :)
|
|
|
|
|
|
2015-01-21 02:58:58 +08:00
|
|
|
## Android Studio
|
2012-03-31 00:37:29 +08:00
|
|
|
|
2015-04-07 22:12:20 +08:00
|
|
|
1. Use "Import Project" and import the `test` directory.
|
|
|
|
|
2. Right click on the `org.apache.cordova.test` package on the left-hand nav.
|
|
|
|
|
3. Select `Create Run Configuration` -> `Tests in ...` (The one with the Android icon)
|
|
|
|
|
4. Review options (mainly - target device)
|
|
|
|
|
5. Click the bug icon in the top toolbar to run with debugger attached
|
