Merge "android.net.lowpan: Added basic unit tests."

LOCAL_AIDL_INCLUDES += frameworks/base/core/java

LOCAL_SRC_FILES += $(call all-Iaidl-files-under, java/android/net/lowpan)

include $(BUILD_SHARED_LIBRARY)

include $(call all-makefiles-under,$(LOCAL_PATH))

endif

# Copyright (C) 2017 The Android Open Source Project

#

# Licensed 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

#

#      http://www.apache.org/licenses/LICENSE-2.0

#

# 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.

LOCAL_PATH:= $(call my-dir)

# Make test APK

# ============================================================

include $(CLEAR_VARS)

LOCAL_MODULE_TAGS := tests

LOCAL_SRC_FILES := $(call all-subdir-java-files)

# This list is generated from the java source files in this module

# The list is a comma separated list of class names with * matching zero or more characters.

# Example:

#   Input files: src/com/android/server/lowpan/Test.java src/com/android/server/lowpan/AnotherTest.java

#   Generated exclude list: com.android.server.lowpan.Test*,com.android.server.lowpan.AnotherTest*

# Filter all src files to just java files

local_java_files := $(filter %.java,$(LOCAL_SRC_FILES))

# Transform java file names into full class names.

# This only works if the class name matches the file name and the directory structure

# matches the package.

local_classes := $(subst /,.,$(patsubst src/%.java,%,$(local_java_files)))

# Utility variables to allow replacing a space with a comma

comma:= ,

empty:=

space:= $(empty) $(empty)

# Convert class name list to jacoco exclude list

# This appends a * to all classes and replace the space separators with commas.

# These patterns will match all classes in this module and their inner classes.

jacoco_exclude := $(subst $(space),$(comma),$(patsubst %,%*,$(local_classes)))

jacoco_include := android.net.lowpan.*

LOCAL_JACK_COVERAGE_INCLUDE_FILTER := $(jacoco_include)

LOCAL_JACK_COVERAGE_EXCLUDE_FILTER := $(jacoco_exclude)

LOCAL_STATIC_JAVA_LIBRARIES := \

	android-support-test \

	guava \

	mockito-target-minus-junit4 \

	frameworks-base-testutils \

LOCAL_JAVA_LIBRARIES := \

	android.test.runner \

LOCAL_PACKAGE_NAME := FrameworksLowpanApiTests

LOCAL_COMPATIBILITY_SUITE := device-tests

LOCAL_CERTIFICATE := platform

LOCAL_ADDITIONAL_DEPENDENCIES := $(LOCAL_PATH)/Android.mk

include $(BUILD_PACKAGE)

<?xml version="1.0" encoding="utf-8"?>

<!--

  ~ Copyright (C) 2017 The Android Open Source Project

  ~

  ~ Licensed 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

  ~

  ~      http://www.apache.org/licenses/LICENSE-2.0

  ~

  ~ 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

  -->

<manifest xmlns:android="http://schemas.android.com/apk/res/android"

    package="android.net.lowpan.test">

    <application>

        <uses-library android:name="android.test.runner" />

        <activity android:label="LowpanTestDummyLabel"

                  android:name="LowpanTestDummyName">

            <intent-filter>

                <action android:name="android.intent.action.MAIN" />

                <category android:name="android.intent.category.LAUNCHER"/>

            </intent-filter>

        </activity>

    </application>

    <instrumentation android:name="android.support.test.runner.AndroidJUnitRunner"

        android:targetPackage="android.net.lowpan.test"

        android:label="Frameworks LoWPAN API Tests">

    </instrumentation>

</manifest>

<?xml version="1.0" encoding="utf-8"?>

<!-- Copyright (C) 2017 The Android Open Source Project

     Licensed 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

          http://www.apache.org/licenses/LICENSE-2.0

     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.

-->

<configuration description="Runs Frameworks LoWPAN API Tests.">

    <target_preparer class="com.android.tradefed.targetprep.TestAppInstallSetup">

        <option name="test-file-name" value="FrameworksLowpanApiTests.apk" />

    </target_preparer>

    <option name="test-suite-tag" value="apct" />

    <option name="test-tag" value="FrameworksLowpanApiTests" />

    <test class="com.android.tradefed.testtype.AndroidJUnitTest" >

        <option name="package" value="android.net.lowpan.test" />

        <option name="runner" value="android.support.test.runner.AndroidJUnitRunner" />

    </test>

</configuration>

# LoWPAN Unit Tests

This package contains unit tests for the android LoWPAN framework System APIs based on the

[Android Testing Support Library](http://developer.android.com/tools/testing-support-library/index.html).

The test cases are built using the [JUnit](http://junit.org/) and [Mockito](http://mockito.org/)

libraries.

## Running Tests

The easiest way to run tests is simply run

```

frameworks/base/lowpan/tests/runtests.sh

```

`runtests.sh` will build the test project and all of its dependencies and push the APK to the

connected device. It will then run the tests on the device.

To pick up changes in framework/base, you will need to:

1. rebuild the framework library 'make -j32'

2. sync over the updated library to the device 'adb sync'

3. restart framework on the device 'adb shell stop' then 'adb shell start'

To enable syncing data to the device for first time after clean reflash:

1. adb disable-verity

2. adb reboot

3. adb remount

See below for a few example of options to limit which tests are run.

See the

[AndroidJUnitRunner Documentation](https://developer.android.com/reference/android/support/test/runner/AndroidJUnitRunner.html)

for more details on the supported options.

```

runtests.sh -e package android.net.lowpan

runtests.sh -e class android.net.lowpan.LowpanManagerTest

```

If you manually build and push the test APK to the device you can run tests using

```

adb shell am instrument -w 'android.net.wifi.test/android.support.test.runner.AndroidJUnitRunner'

```

## Adding Tests

Tests can be added by adding classes to the src directory. JUnit4 style test cases can

be written by simply annotating test methods with `org.junit.Test`.

## Debugging Tests

If you are trying to debug why tests are not doing what you expected, you can add android log

statements and use logcat to view them. The beginning and end of every tests is automatically logged

with the tag `TestRunner`.