Skip to content

Clean up the documentation for the library testing #59401

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
MaximLipnin merged 15 commits into from
Nov 8, 2021
Merged

Clean up the documentation for the library testing #59401

Changes from 1 commit
Commits
Show all changes
15 commits
Select commit Hold shift + click to select a range
6f3d24f
Clean up the doc for the library testing on Android
MaximLipnin Sep 21, 2021
a17fe25
Add a section about functional tests
MaximLipnin Sep 21, 2021
6a10f2d
Update the doc for testing on apple mobile platforms
MaximLipnin Sep 21, 2021
9a3f044
Initial note on testing various configurations on apple mobile platforms
MaximLipnin Sep 21, 2021
c550324
Trailing spaces
MaximLipnin Sep 21, 2021
886789d
Fix links
MaximLipnin Sep 21, 2021
f3a23f4
Fix a link
MaximLipnin Sep 21, 2021
d045edb
Fix a typo
MaximLipnin Sep 21, 2021
d550d51
Trailing spaces
MaximLipnin Sep 21, 2021
494d96e
Use a build parameter for configuration
MaximLipnin Sep 22, 2021
819c852
Use a build parameter for configuration
MaximLipnin Sep 22, 2021
ea6d849
Add the functional tests section to the Mono general testing document
MaximLipnin Sep 23, 2021
c975413
Merge branch 'main' into cleanup_testing_doc
MaximLipnin Oct 4, 2021
9af3c51
address the feedback
MaximLipnin Oct 4, 2021
1863728
Trailing spaces
MaximLipnin Oct 4, 2021
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Next Next commit
Clean up the doc for the library testing on Android
  • Loading branch information
@MaximLipnin
MaximLipnin committed Sep 21, 2021
commit 6f3d24ffefef5b6828c0c7b2e209648dd61df331
25 changes: 21 additions & 4 deletions docs/workflow/testing/libraries/testing-android.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,18 +1,23 @@
# Testing Libraries on Android

## Prerequisites

The following dependencies should be installed in order to be able to run tests:

- OpenJDK
- Android NDK
- Android SDK
- OpenJDK
- OpenSSL

To manage the dependencies, you can install them via terminal or using Android Studio.

### Using a terminal

OpenJDK can be installed on Linux (Ubuntu) using `apt-get`:
```bash
sudo apt-get install openjdk-8 zip unzip
```

Android SDK, NDK and OpenSSL can be automatically installed via the following script:
Android SDK and NDK can be automatically installed via the following script:
```bash
#!/usr/bin/env bash
set -e
Expand All @@ -21,7 +26,6 @@ NDK_VER=r21b
SDK_VER=6200805_latest
SDK_API_LEVEL=29
SDK_BUILD_TOOLS=29.0.3
OPENSSL_VER=1.1.1g-alpha-1

if [[ "$OSTYPE" == "darwin"* ]]; then
HOST_OS=darwin
Expand All @@ -47,8 +51,21 @@ yes | ${ANDROID_SDK_ROOT}/cmdline-tools/tools/bin/sdkmanager --sdk_root=${ANDROI
${ANDROID_SDK_ROOT}/cmdline-tools/tools/bin/sdkmanager --sdk_root=${ANDROID_SDK_ROOT} "platform-tools" "platforms;android-${SDK_API_LEVEL}" "build-tools;${SDK_BUILD_TOOLS}"
```

### Using Android Studio

Android Studio offers a convenient UI:
- to install all the dependencies;
- to manage android virtual devices;
- to make easy use of adb logs.

## Building Libs and Tests for Android

Before running a build you might want to set the Android SDK and NDK environment variables:
```
export ANDROID_SDK_ROOT=<PATH-TO-ANDROID-SDK>
export ANDROID_NDK_ROOT=<PATH-TO-ANDROID-NDK>
```

Now we're ready to build everything for Android:
```
./build.sh mono+libs -os Android -arch x64
Expand Down