Skip to content

Commit 131d373

Browse files
committed
Add doc for android startup scenario local testing
1 parent f922701 commit 131d373

File tree

2 files changed

+37
-0
lines changed

2 files changed

+37
-0
lines changed

docs/android-startup-scenarios.md

+35
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,35 @@
1+
2+
# Android Startup Test
3+
4+
## Prereqs
5+
6+
- Ensure `dotnet` is installed and available with the `dotnet` command. [Dotnet Download](https://dotnet.microsoft.com/en-us/download) or [Daily Dotnet Download](https://github.com/dotnet/sdk/blob/main/documentation/package-table.md)
7+
- Ensure `xharness` is installed and available with the `xharness` command. The current version in use can be found in the `eng/performance/maui_scenarios_android.proj` file at line 7 (under the tag `MicrosoftDotNetXHarnessCLIVersion`), although any recent version should work. [XHarness Install Instructions](https://github.com/dotnet/xharness?tab=readme-ov-file#installation-and-usage).
8+
- Have an Android app APK available for testing.
9+
10+
## Steps
11+
12+
1. Initialize the environment (note the . for bash):
13+
14+
```sh
15+
cd src/scripts
16+
. ./init.sh # or .\init.ps1 on Windows
17+
cd ../
18+
```
19+
20+
2. Navigate to the `helloandroid` scenario directory:
21+
22+
```sh
23+
cd ./scenarios/helloandroid
24+
```
25+
26+
3. Copy the APK into the `helloandroid` directory.
27+
4. Run the test:
28+
29+
```sh
30+
python test.py devicestartup --device-type android --package-path <path to apk (e.g. .)>/<apkname>.apk --package-name <apk package name> [--disable-animations]
31+
```
32+
33+
## Notes
34+
35+
- Example commands and additional logic can be found in the `maui_scenarios_android.proj` and `runner.py` files in the `performance` repository.

docs/scenarios-workflow.md

+2
Original file line numberDiff line numberDiff line change
@@ -12,6 +12,7 @@ This is a general guideline on how the scenario tests are arranged in this repo.
1212
- [How to run SDK scenario tests](./sdk-scenarios.md)
1313
- [How to run Crossgen scenario tests](./crossgen-scenarios.md)
1414
- [How to run Blazor tests](./blazor-scenarios.md)
15+
- [How to run Android Startup tests](./android-startup-scenarios.md)
1516
- [How to run other Scenario tests](./basic-scenarios.md)
1617

1718
### Prerequisites
@@ -138,4 +139,5 @@ Some command options are only applicable for certain test assets. Refer to the c
138139
- [SDK Command Matrix](./sdk-scenarios.md#command-matrix)
139140
- [Crossgen Command Matrix](./crossgen-scenarios.md#command-matrix)
140141
- [Blazor Command Matrix](./blazor-scenarios.md#command-matrix)
142+
- [How to run Android Startup tests](./android-startup-scenarios.md)
141143
- [Other Scenarios Command Matrix](./basic-scenarios.md#command-matrix)

0 commit comments

Comments
 (0)