Description

freakboy3742

opened on Mar 26, 2026

Issue body actions

As part of the general cleanup of the repository to put all platform build tooling into the Platforms folder, we need to move the Android folder to Platforms/Android.

Linked PRs

• gh-146445: Migrate Android build tools to the Platforms folder. #148282
• gh-146445: Update CODEOWNERS for Android and iOS migration to Platforms directory #149543
• [3.15] gh-146445: Update CODEOWNERS for Android and iOS migration to Platforms directory (GH-149543) #149545

Activity

1. freakboy3742

   self-assigned this

   on Mar 26, 2026
2. freakboy3742

   added

   OS-android

   on Mar 26, 2026
3. picnixz

   added

   type-refactorCode refactoring (with no changes in behavior)Code refactoring (with no changes in behavior)

   triagedThe issue has been accepted as valid by a triager.The issue has been accepted as valid by a triager.

   on Mar 26, 2026
4. freakboy3742 commented on Mar 27, 2026

   

   freakboy3742

   on Mar 27, 2026

   ContributorAuthor

   More actions

   @mhsmith As part of this migration, I'd like to move the android.py script to Platform/Android/__main__.py; that makes the build script entry point consistent with Emscripten, iOS and WASI.

   Two questions that emerge from that:

   1. Do you think we need to retain the Android/android.py script as a backwards compatibility shim? Can you think of anything outside the CPython build ecosystem that might be relying on that location in the Python source tree? I haven't done this for iOS, on the basis that the only consumers of that folder is CPython's own build processes.
   2. I know cibuildwheel relies on the android.py name in the release package, so I'll need to rename it there as part of the packaging process; but is there anything else you can think of that might be relying on the android.py name specifically?
5. mhsmith commented on Apr 1, 2026

   

   mhsmith

   on Apr 1, 2026

   Member

   More actions

   Apart from cibuldwheel, I don't think there are any other external references to the android.py name. However, there are many references in the Android/README, and in android.py itself via SCRIPT_NAME.

   The README in particular would be awkward to update to accommodate two names, so maybe we can leave android.py at its original name, and add a __main__.py launcher script to provide a consistent entry point.

   There are also a couple of references to the Android/README path that would need to be updated, including Doc/using/android.rst, and the dev guide, which looks like it might need some updates for Emscripten and iOS as well. WASI has already been updated, and uses tabs to handle differences between different Python versions.
6. freakboy3742 commented on Apr 2, 2026

   

   freakboy3742

   on Apr 2, 2026

   ContributorAuthor

   More actions

   Agreed there's a bunch of dev guide references that need updates. That work is on my todo list.

   I'm not sure the README issue is that bad. To my read, most of the potential confusion comes because the "how you run the test suite" assumes running the CPython test suite with a release package is a common use case. While it's certainly possible, I think the instructions can be made fairly clear by separating the "how to test CPython" from "how to test your third party package". I'll include that rework in my PR applying the rename.

   Reacted by Malcolm Smith
7. freakboy3742

   added a commit that references this issue on Apr 13, 2026

   gh-146445: Migrate Android build tools to the Platforms folder. (#148282

   bf452f7
8. freakboy3742

   closed this as completedin #148282on Apr 13, 2026
9. ljfp

   added a commit that references this issue on Apr 25, 2026

   pythongh-146445: Migrate Android build tools to the Platforms folder. (…

   80bccb1
10. hugovk

    added 2 commits that reference this issue on May 8, 2026

    gh-146445: Update CODEOWNERS for Android and iOS migration to Platfor…

    5b58fbc

    [3.15] gh-146445: Update CODEOWNERS for Android and iOS migration to …

    831dac8

Issue actions