python · encukou · May 1, 2024 · Apr 14, 2024 · Apr 14, 2024 · Apr 14, 2024
@@ -243,6 +243,18 @@ Lib/test/support/interpreters/  @ericsnowcurrently
 Modules/_xx*interp*module.c   @ericsnowcurrently
 Lib/test/test_interpreters/   @ericsnowcurrently
 
+# Android
+**/*Android*                  @mhsmith
+**/*android*                  @mhsmith
+
+# iOS (but not termios)
+**/iOS*                       @freakboy3742
+**/ios*                       @freakboy3742
+**/*_iOS*                     @freakboy3742
+**/*_ios*                     @freakboy3742
+**/*-iOS*                     @freakboy3742
+**/*-ios*                     @freakboy3742
+
 # WebAssembly
 /Tools/wasm/                  @brettcannon
 

@@ -43,9 +43,10 @@ The discrete steps for building via `android.py` are:
 ./android.py make-host HOST
 ```
 
-To see the possible values of HOST, run `./android.py configure-host --help`.
+`HOST` identifies which architecture to build. To see the possible values, run
+`./android.py configure-host --help`.
 
-Or to do it all in a single command, run:
+To do all steps in a single command, run:
 
 ```sh
 ./android.py build HOST
@@ -62,3 +63,20 @@ call. For example, if you want a pydebug build that also caches the results from
 ```sh
 ./android.py build HOST -- -C --with-pydebug
 ```
+
+
+## Testing
+
+To run the Python test suite on Android:
+
+* Follow the instructions in the previous section to build all supported
+  architectures.
+* Open the `testbed` directory in Android Studio.
+* Connect a device, or start an emulator, and select it from the drop-down list
+  in the toolbar.
+* Click the "Run" button in the toolbar.
+* The testbed app displays nothing on screen while running. To see its output,
+  open the [Logcat window](https://developer.android.com/studio/debug/logcat).
+
+To run specific tests, or pass any other arguments to the test suite, edit the
+command line in testbed/app/src/main/python/main.py.
@@ -0,0 +1,19 @@
+# Cancel a rule from the repository's top-level .gitignore file.
+!.idea
+
+*.iml
+.gradle
+/local.properties
+/.idea/caches
+/.idea/deploymentTargetDropdown.xml
+/.idea/libraries
+/.idea/modules.xml
+/.idea/workspace.xml
+/.idea/navEditor.xml
+/.idea/assetWizardSettings.xml
+.DS_Store
+/build
+/captures
+.externalNativeBuild
+.cxx
+local.properties
diff --git a/Android/testbed/.idea/.gitignore b/Android/testbed/.idea/.gitignore
diff --git a/Android/testbed/.idea/.name b/Android/testbed/.idea/.name
diff --git a/Android/testbed/.idea/codeStyles/Project.xml b/Android/testbed/.idea/codeStyles/Project.xml
diff --git a/Android/testbed/.idea/codeStyles/codeStyleConfig.xml b/Android/testbed/.idea/codeStyles/codeStyleConfig.xml
diff --git a/Android/testbed/.idea/compiler.xml b/Android/testbed/.idea/compiler.xml
diff --git a/Android/testbed/.idea/gradle.xml b/Android/testbed/.idea/gradle.xml
diff --git a/Android/testbed/.idea/inspectionProfiles/Project_Default.xml b/Android/testbed/.idea/inspectionProfiles/Project_Default.xml
diff --git a/Android/testbed/.idea/kotlinc.xml b/Android/testbed/.idea/kotlinc.xml
diff --git a/Android/testbed/.idea/migrations.xml b/Android/testbed/.idea/migrations.xml
diff --git a/Android/testbed/.idea/misc.xml b/Android/testbed/.idea/misc.xml
diff --git a/Android/testbed/.idea/vcs.xml b/Android/testbed/.idea/vcs.xml
@@ -0,0 +1 @@
+/build