Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
19 commits
Select commit Hold shift + click to select a range
8123eed
Add AndroidInnerLoopParser for build/deploy binlog analysis
davidnguyen-tech Mar 31, 2026
f6c5869
Add ANDROIDINNERLOOP test type to Python test framework
davidnguyen-tech Mar 31, 2026
7740568
Add MAUI Android inner loop scenario scripts
davidnguyen-tech Mar 31, 2026
3f5e643
Wire MAUI Android inner loop into CI pipeline
davidnguyen-tech Mar 31, 2026
746709a
Make screen timeout configurable and validate cold startup LaunchState
davidnguyen-tech Apr 1, 2026
986c7bf
Address review notes
davidnguyen-tech Apr 1, 2026
26ea3ea
Address review notes 2
davidnguyen-tech Apr 7, 2026
59d3d40
Add SDK version capture + diagnostics to mauiandroidinnerloop
davidnguyen-tech Apr 21, 2026
efd2217
Address copilot review notes
davidnguyen-tech Apr 21, 2026
d73f5fb
Log rollback_maui.json contents on Helix machine
davidnguyen-tech Apr 22, 2026
d5da6c1
Switch MAUI Android Inner Loop to 'dotnet run -p:WaitForExit=false'
davidnguyen-tech Apr 22, 2026
c47d731
Migrate MAUI Android Inner Loop startup measurement to logcat polling
davidnguyen-tech Apr 23, 2026
7c1e3bf
Remove stale Android cold startup helper
davidnguyen-tech Apr 27, 2026
e2abd8d
Address PR review findings
davidnguyen-tech Apr 30, 2026
27ef49a
Reject non-Debug BuildConfig for MAUI Android Inner Loop
davidnguyen-tech May 5, 2026
57d68ff
Address PR review: align with Android verifier-disable + clarify semi…
davidnguyen-tech May 5, 2026
0f1a76c
Revert verifier-disable change; keep semicolon-list help text
davidnguyen-tech May 5, 2026
d019e81
Revert ValidateInnerLoopBuildConfig guard and -c $(BuildConfig) switch
davidnguyen-tech May 6, 2026
802b12f
Document why -c Debug is hardcoded in inner loop scenario
davidnguyen-tech May 6, 2026
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
102 changes: 102 additions & 0 deletions eng/performance/maui_scenarios_android_innerloop.proj
Original file line number Diff line number Diff line change
@@ -0,0 +1,102 @@
<Project Sdk="Microsoft.DotNet.Helix.Sdk" DefaultTargets="Test">
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This file is redundant with the existing eng/performance/maui_scenarios_android.proj. Could we just add the new HelixWorkItem to the maui_scenarios_android.proj and condition on the inner dev loop?

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Yes, we could - I had a prototype for that approach and from ultra-high level, but the Inner Loop scenario seemed too different from the other ones and it looked approximately like this:

  • if inner_loop:
    • ...
  • else:
    • ...

Don't have a strong opinion on this, happy to switch to using just one .proj file :)


<Import Project="Scenarios.Common.props" />
<!-- TODO: Scenarios.Common.props sets HelixResultsDestinationDir to a path under
CorrelationPayloadDirectory, which is cleaned up after SendToHelix. As a result,
this file's DownloadFilesFromResults artifacts (e.g., output.log) may not appear
in published pipeline artifacts. A future fix should override
HelixResultsDestinationDir to a path under ArtifactStagingDirectory that the
pipeline's "Gather logs" step publishes. -->

<PropertyGroup>
<IncludeXHarnessCli>true</IncludeXHarnessCli>
</PropertyGroup>

<PropertyGroup>
<_MSBuildArgs Condition="'$(RuntimeFlavor)' == 'mono'">/p:UseMonoRuntime=true</_MSBuildArgs>
<_MSBuildArgs Condition="'$(RuntimeFlavor)' == 'coreclr'">/p:UseMonoRuntime=false</_MSBuildArgs>

<!-- CoreCLR: disable ReadyToRun so inner loop measures JIT behavior -->
<_MSBuildArgs Condition="'$(RuntimeFlavor)' == 'coreclr'">$(_MSBuildArgs);/p:PublishReadyToRun=false;/p:PublishReadyToRunComposite=false</_MSBuildArgs>

<!-- AndroidRid: defaults based on target OS but can be overridden.
Windows targets physical devices; Linux targets emulators. -->
<AndroidRid Condition="'$(AndroidRid)' == '' and '$(TargetsWindows)' == 'true'">android-arm64</AndroidRid>
<AndroidRid Condition="'$(AndroidRid)' == '' and '$(TargetsWindows)' != 'true'">android-x64</AndroidRid>
<_MSBuildArgs>$(_MSBuildArgs) /p:RuntimeIdentifier=$(AndroidRid)</_MSBuildArgs>

<!-- TODO: https://github.com/dotnet/maui/issues/34706 -->
<_MSBuildArgs>$(_MSBuildArgs) /p:SupportedOSPlatformVersion=23</_MSBuildArgs>
<!-- Add TargetFrameworks override so dotnet build's implicit restore
only evaluates the android TFM, not multi-platform TFMs in the csproj. -->
<_MSBuildArgs Condition="!$(_MSBuildArgs.Contains('/p:TargetFrameworks='))">$(_MSBuildArgs) /p:TargetFrameworks=$(PERFLAB_Framework)-android</_MSBuildArgs>

<RunConfigsString>$(RuntimeFlavor)_$(CodegenType)</RunConfigsString>
<InnerLoopIterations Condition="'$(InnerLoopIterations)' == ''">10</InnerLoopIterations>
<!-- Screen timeout must be large enough so the display stays on for the entire scenario.
If the screen turns off mid-run, ActivityTaskManager never emits the 'Displayed' line
and measure_startup_from_logcat will time out. -->
<ScreenTimeoutMs Condition="'$(ScreenTimeoutMs)' == ''">1800000</ScreenTimeoutMs>
</PropertyGroup>

<!-- Remove .NET SDK packs from the Helix correlation payload to reduce transfer size.
The workload packs (~1-2 GB) are restored on the Helix machine during the run step,
so shipping them in the payload is unnecessary and slows down payload upload. -->
<Target Name="RemoveDotnetFromCorrelationStaging" BeforeTargets="BeforeTest">
<Message Text="Removing Dotnet Packs from Correlation Staging" Importance="high" />
<RemoveDir Directories="$(CorrelationPayloadDirectory)dotnet\packs" Condition="'$(TargetsWindows)' == 'true'" />
<RemoveDir Directories="$(CorrelationPayloadDirectory)dotnet/packs" Condition="'$(TargetsWindows)' != 'true'" />
</Target>

<ItemDefinitionGroup>
<HelixWorkItem>
<Timeout>01:00</Timeout>
</HelixWorkItem>
</ItemDefinitionGroup>

<ItemGroup>
<MAUIAndroidInnerLoopScenario Include="MAUI Android Inner Loop">
<ScenarioDirectoryName>mauiandroidinnerloop</ScenarioDirectoryName>
<PayloadDirectory>$(ScenariosDir)%(ScenarioDirectoryName)</PayloadDirectory>
</MAUIAndroidInnerLoopScenario>
</ItemGroup>

<!-- PreparePayloadWorkItem: create template and modified source on the build machine.
pre.py creates the MAUI template in app/, fixes .csproj TFMs, and prepares the
modified MainPage.xaml.cs in src/ for the incremental deploy simulation. -->
<ItemGroup>
<PreparePayloadWorkItem Include="@(MAUIAndroidInnerLoopScenario)">
<Command>$(Python) pre.py default -f $(PERFLAB_Framework)</Command>
<WorkingDirectory>%(PreparePayloadWorkItem.PayloadDirectory)</WorkingDirectory>
</PreparePayloadWorkItem>
</ItemGroup>

<!-- Environment variables needed on Helix before setup_helix.py runs (so PATH includes adb). -->
<PropertyGroup>
<_WindowsEnvVars>set DOTNET_ROOT=%HELIX_CORRELATION_PAYLOAD%\dotnet;set DOTNET_CLI_TELEMETRY_OPTOUT=1;set DOTNET_MULTILEVEL_LOOKUP=0;set NUGET_PACKAGES=%HELIX_WORKITEM_ROOT%\.packages;set ANDROID_HOME=%HELIX_WORKITEM_ROOT%\android-sdk;set ANDROID_SDK_ROOT=%HELIX_WORKITEM_ROOT%\android-sdk;set JAVA_HOME=%HELIX_WORKITEM_ROOT%\jdk;set PATH=%HELIX_CORRELATION_PAYLOAD%\dotnet;;%HELIX_WORKITEM_ROOT%\android-sdk\platform-tools;;%HELIX_WORKITEM_ROOT%\jdk\bin;;%PATH%</_WindowsEnvVars>
<_LinuxEnvVars>export DOTNET_ROOT=$HELIX_CORRELATION_PAYLOAD/dotnet;export DOTNET_CLI_TELEMETRY_OPTOUT=1;export DOTNET_MULTILEVEL_LOOKUP=0;export NUGET_PACKAGES=$HELIX_WORKITEM_ROOT/.packages;export ANDROID_HOME=$HELIX_WORKITEM_ROOT/android-sdk;export ANDROID_SDK_ROOT=$HELIX_WORKITEM_ROOT/android-sdk;export JAVA_HOME=$HELIX_WORKITEM_ROOT/jdk;export ANDROID_SERIAL=emulator-5554;export PATH=$HELIX_CORRELATION_PAYLOAD/dotnet:$HELIX_WORKITEM_ROOT/android-sdk/platform-tools:$HELIX_WORKITEM_ROOT/jdk/bin:$PATH</_LinuxEnvVars>
Comment thread
davidnguyen-tech marked this conversation as resolved.
</PropertyGroup>

<ItemGroup Condition="'$(TargetsWindows)' == 'true'">
<!-- NOTE: The scenario is only relevant in Debug mode. Do NOT use Release mode. -->
<HelixWorkItem Include="@(MAUIAndroidInnerLoopScenario -> 'Inner Loop Device - %(Identity)')">
<PreCommands>$(_WindowsEnvVars);$(Python) setup_helix.py $(PERFLAB_Framework)-android &quot;$(_MSBuildArgs)&quot;</PreCommands>
<Command>$(Python) test.py androidinnerloop --csproj-path app/MauiAndroidInnerLoop.csproj --edit-src &quot;src/MainPage.xaml.cs;src/MainPage.xaml&quot; --edit-dest &quot;app/Pages/MainPage.xaml.cs;app/Pages/MainPage.xaml&quot; --package-name com.companyname.mauiandroidinnerloop -f $(PERFLAB_Framework)-android -c Debug --msbuild-args &quot;$(_MSBuildArgs)&quot; --scenario-name &quot;%(Identity)&quot; --inner-loop-iterations $(InnerLoopIterations) --screen-timeout-ms $(ScreenTimeoutMs) $(ScenarioArgs)</Command>
<PostCommands>$(Python) post.py</PostCommands>
<DownloadFilesFromResults>output.log</DownloadFilesFromResults>
</HelixWorkItem>
</ItemGroup>

<ItemGroup Condition="'$(TargetsWindows)' != 'true'">
<!-- NOTE: The scenario is only relevant in Debug mode. Do NOT use Release mode. -->
<HelixWorkItem Include="@(MAUIAndroidInnerLoopScenario -> 'Inner Loop Emulator - %(Identity)')">
<PreCommands>$(_LinuxEnvVars);$(Python) setup_helix.py $(PERFLAB_Framework)-android &quot;$(_MSBuildArgs)&quot;</PreCommands>
<Command>$(Python) test.py androidinnerloop --csproj-path app/MauiAndroidInnerLoop.csproj --edit-src &quot;src/MainPage.xaml.cs;src/MainPage.xaml&quot; --edit-dest &quot;app/Pages/MainPage.xaml.cs;app/Pages/MainPage.xaml&quot; --package-name com.companyname.mauiandroidinnerloop -f $(PERFLAB_Framework)-android -c Debug --msbuild-args &quot;$(_MSBuildArgs)&quot; --scenario-name &quot;%(Identity)&quot; --inner-loop-iterations $(InnerLoopIterations) --screen-timeout-ms $(ScreenTimeoutMs) $(ScenarioArgs)</Command>
<PostCommands>$(Python) post.py</PostCommands>
<DownloadFilesFromResults>output.log</DownloadFilesFromResults>
</HelixWorkItem>
</ItemGroup>

<Import Project="PreparePayloadWorkItems.targets" />

</Project>
78 changes: 78 additions & 0 deletions eng/pipelines/sdk-perf-jobs.yml
Original file line number Diff line number Diff line change
Expand Up @@ -527,6 +527,84 @@ jobs:
${{ each parameter in parameters.jobParameters }}:
${{ parameter.key }}: ${{ parameter.value }}

# Maui Android inner loop benchmarks on devices (Mono Default) - Debug
- template: /eng/pipelines/templates/build-machine-matrix.yml
parameters:
jobTemplate: /eng/pipelines/templates/run-scenarios-job.yml
buildMachines:
- win-x64-android-arm64-pixel
Comment thread
davidnguyen-tech marked this conversation as resolved.
- win-x64-android-arm64-galaxy
isPublic: false
jobParameters:
runKind: maui_scenarios_android_innerloop
projectFileName: maui_scenarios_android_innerloop.proj
channels:
- main
runtimeFlavor: mono
codeGenType: Default
buildConfig: Debug
additionalJobIdentifier: Mono_Debug_InnerLoop
${{ each parameter in parameters.jobParameters }}:
${{ parameter.key }}: ${{ parameter.value }}

# Maui Android inner loop benchmarks on devices (CoreCLR Default) - Debug
- template: /eng/pipelines/templates/build-machine-matrix.yml
parameters:
jobTemplate: /eng/pipelines/templates/run-scenarios-job.yml
buildMachines:
- win-x64-android-arm64-pixel
- win-x64-android-arm64-galaxy
isPublic: false
jobParameters:
runKind: maui_scenarios_android_innerloop
projectFileName: maui_scenarios_android_innerloop.proj
channels:
- main
runtimeFlavor: coreclr
codeGenType: Default
buildConfig: Debug
additionalJobIdentifier: CoreCLR_Debug_InnerLoop
${{ each parameter in parameters.jobParameters }}:
${{ parameter.key }}: ${{ parameter.value }}

# Maui Android inner loop benchmarks on emulator (Mono Default) - Debug
- template: /eng/pipelines/templates/build-machine-matrix.yml
parameters:
jobTemplate: /eng/pipelines/templates/run-scenarios-job.yml
buildMachines:
- ubuntu-x64-android-emulator
isPublic: false
jobParameters:
runKind: maui_scenarios_android_innerloop
projectFileName: maui_scenarios_android_innerloop.proj
channels:
- main
runtimeFlavor: mono
codeGenType: Default
buildConfig: Debug
additionalJobIdentifier: Mono_Debug_InnerLoop_Emulator
${{ each parameter in parameters.jobParameters }}:
${{ parameter.key }}: ${{ parameter.value }}

# Maui Android inner loop benchmarks on emulator (CoreCLR Default) - Debug
- template: /eng/pipelines/templates/build-machine-matrix.yml
parameters:
jobTemplate: /eng/pipelines/templates/run-scenarios-job.yml
buildMachines:
- ubuntu-x64-android-emulator
isPublic: false
jobParameters:
runKind: maui_scenarios_android_innerloop
projectFileName: maui_scenarios_android_innerloop.proj
channels:
- main
runtimeFlavor: coreclr
codeGenType: Default
buildConfig: Debug
additionalJobIdentifier: CoreCLR_Debug_InnerLoop_Emulator
${{ each parameter in parameters.jobParameters }}:
${{ parameter.key }}: ${{ parameter.value }}

# Maui iOS scenario benchmarks (Mono - Default) - Debug
- template: /eng/pipelines/templates/build-machine-matrix.yml
parameters:
Expand Down
13 changes: 13 additions & 0 deletions eng/pipelines/templates/build-machine-matrix.yml
Original file line number Diff line number Diff line change
Expand Up @@ -146,6 +146,19 @@ jobs:
machinePool: GalaxyA16
${{ insert }}: ${{ parameters.jobParameters }}

- ${{ if and(containsValue(parameters.buildMachines, 'ubuntu-x64-android-emulator'), not(eq(parameters.isPublic, true))) }}: # Ubuntu x64 Android emulator only used in private builds currently
- template: ${{ parameters.jobTemplate }}
parameters:
osGroup: ubuntu
archType: x64
osVersion: 2204
pool:
vmImage: ubuntu-latest
container: ubuntu_x64_build_container
queue: Ubuntu.2204.Amd64.Android.36
machinePool: AndroidEmulator
${{ insert }}: ${{ parameters.jobParameters }}

- ${{ if and(containsValue(parameters.buildMachines, 'osx-x64-ios-arm64'), not(eq(parameters.isPublic, true))) }}: # iPhone ARM64 17 only used in private builds currently
- template: ${{ parameters.jobTemplate }}
parameters:
Expand Down
2 changes: 1 addition & 1 deletion eng/pipelines/templates/run-performance-job.yml
Original file line number Diff line number Diff line change
Expand Up @@ -190,7 +190,7 @@ jobs:
- '--is-scenario'
- ${{ if ne(length(parameters.runEnvVars), 0) }}:
- "--run-env-vars ${{ join(' ', parameters.runEnvVars)}}"
- ${{ if and(in(parameters.runKind, 'maui_scenarios_ios', 'maui_scenarios_android'), ne(parameters.runtimeFlavor, '')) }}:
- ${{ if and(in(parameters.runKind, 'maui_scenarios_ios', 'maui_scenarios_android', 'maui_scenarios_android_innerloop'), ne(parameters.runtimeFlavor, '')) }}:
- '--runtime-flavor ${{ parameters.runtimeFlavor }}'
- ${{ if ne(parameters.osVersion, '') }}:
- '--os-version ${{ parameters.osVersion }}'
Expand Down
6 changes: 3 additions & 3 deletions scripts/run_performance_job.py
Original file line number Diff line number Diff line change
Expand Up @@ -570,9 +570,9 @@ def get_run_configurations(
configurations["iOSLlvmBuild"] = str(ios_llvm_build)

# .NET Android and .NET MAUI Android sample app scenarios
if run_kind == "maui_scenarios_android":
if run_kind in ["maui_scenarios_android", "maui_scenarios_android_innerloop"]:
if not runtime_flavor in ("mono", "coreclr"):
raise Exception("Runtime flavor must be specified for maui_scenarios_android")
raise Exception(f"Runtime flavor must be specified for {run_kind}")
configurations["CodegenType"] = str(codegen_type)
configurations["RuntimeType"] = str(runtime_flavor)
if build_config is not None and build_config != DEFAULT_BUILD_CONFIG:
Expand Down Expand Up @@ -1190,7 +1190,7 @@ def publish_dotnet_app_to_payload(payload_dir_name: str, csproj_path: str, self_
verbose=True).run()

# Search for additional binlogs generated by the maui scenarios prepare payload work items to copy to the artifacts log dir
if args.run_kind in ["maui_scenarios_android", "maui_scenarios_ios"]:
if args.run_kind in ["maui_scenarios_android", "maui_scenarios_ios", "maui_scenarios_android_innerloop"]:
for binlog_path in glob(os.path.join(payload_dir, "scenarios_out", "**", "*.binlog"), recursive=True):
shutil.copy(binlog_path, ci_artifacts_log_dir)

Expand Down
28 changes: 28 additions & 0 deletions src/scenarios/mauiandroidinnerloop/post.py
Original file line number Diff line number Diff line change
@@ -0,0 +1,28 @@
'''
post cleanup script
'''

import subprocess
import sys
import traceback
from performance.logger import setup_loggers, getLogger
from shared.postcommands import clean_directories
from shared.util import xharness_adb
from test import EXENAME

setup_loggers(True)
logger = getLogger(__name__)

try:
# Uninstall the app from the connected device so re-runs start from a clean state
package_name = f'com.companyname.{EXENAME.lower()}'
logger.info(f"Uninstalling {package_name} from device")
subprocess.run(xharness_adb() + ['uninstall', package_name], check=False)

logger.info("Shutting down dotnet build servers")
subprocess.run(['dotnet', 'build-server', 'shutdown'], check=False)

clean_directories()
except Exception as e:
logger.error(f"Post cleanup failed: {e}\n{traceback.format_exc()}")
sys.exit(1)
Loading