Skip to content

gh-114099: Add configure and Makefile targets to support iOS compilation. #115390

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
ned-deily merged 15 commits into from
Feb 26, 2024
Merged

gh-114099: Add configure and Makefile targets to support iOS compilation. #115390

Changes from 1 commit
Commits
Show all changes
15 commits
Select commit Hold shift + click to select a range
dfd97f8
Add configure and Makefile targets to support iOS compilation.
freakboy3742 Feb 13, 2024
838713d
Improve error handling and reuse in configure.ac.
freakboy3742 Feb 14, 2024
5b54336
Clarifications to iOS README from review.
freakboy3742 Feb 14, 2024
9a5f851
Normalize usage of arm64 in iOS README.
freakboy3742 Feb 14, 2024
8c763af
Move the future location of the iOS testbed project to the iOS folder.
freakboy3742 Feb 16, 2024
95275c1
Corrections to iOS README.
freakboy3742 Feb 17, 2024
9f851b0
Merge branch 'main' into iOS-configure-targets
freakboy3742 Feb 23, 2024
302a5b0
Add note about Command Line Tools, and the need for a Simulator platf…
freakboy3742 Feb 23, 2024
ba946fb
Modify compiler utility scripts to avoid bash, and allow for SDK vers…
freakboy3742 Feb 23, 2024
24b3770
Added support for DESTDIR to iOS framework targets.
freakboy3742 Feb 23, 2024
3a1a6fb
Correct dependency issue with parallel builds.
freakboy3742 Feb 25, 2024
6247052
Correct issue with finding resources when not building from the root …
freakboy3742 Feb 25, 2024
ee41015
Merge branch 'main' into ios-configure-targets
freakboy3742 Feb 25, 2024
49778fe
Removed an unnecessary srcdir usage.
freakboy3742 Feb 26, 2024
8a3cbeb
Clarified the restriction on host python compatibility.
freakboy3742 Feb 26, 2024
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
Prev Previous commit
Next Next commit
Corrections to iOS README.
  • Loading branch information
@freakboy3742
freakboy3742 committed Feb 17, 2024
commit 95275c1db77a27a800dcf9b0ab15d53a9ecec70d
33 changes: 20 additions & 13 deletions iOS/README.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -10,10 +10,10 @@ Python distribution.

These instructions are only needed if you're planning to compile Python for iOS
yourself. Most users should *not* need to do this. If you're looking to
experiment with writing an iOS app in Python on iOS, tools such as `BeeWare's
Briefcase <https://briefcase.readthedocs.io>`__ and `Kivy's Builddozer
<https://buildozer.readthedocs.io>`__ will provide a much more approachable user
experience.
experiment with writing an iOS app in Python, tools such as `BeeWare's Briefcase
<https://briefcase.readthedocs.io>`__ and `Kivy's Buildozer
<https://buildozer.readthedocs.io>`__ will provide a much more approachable
user experience.

Compilers for building on iOS
=============================
Expand All @@ -34,7 +34,7 @@ iOS specific arguments to configure

* ``--with-framework-name=NAME``

Specify the name for the python framework; defaults to ``Python``.
Specify the name for the Python framework; defaults to ``Python``.

Building Python on iOS
======================
Expand Down Expand Up @@ -95,13 +95,20 @@ In this invocation:

* ``iOS/Resources/bin`` has been added to the path, providing some shims for the
compilers and linkers needed by the build. Xcode requires the use of ``xcrun``
to invoke compiler tooling; however, ``xcrun`` embeds user- and
to invoke compiler tooling. However, if ``xcrun`` is pre-evaluated and the
result passed to ``configure``, these results can embed user- and
version-specific paths into the sysconfig data, which limits the portability
of the compiled Python. It also requires that compiler variables like ``CC``
include spaces, which can cause significant problems with many C configuration
systems which assume that ``CC`` will be a single executable. The
``iOS/Resources/bin`` folder contains some wrapper scripts that present as
simple compilers and linkers, but wrap underlying calls to ``xcrun``.
of the compiled Python. Alternatively, if ``xcrun`` is used *as* the compiler,
it requires that compiler variables like ``CC`` include spaces, which can
cause significant problems with many C configuration systems which assume that
``CC`` will be a single executable.

To work around this problem, the ``iOS/Resources/bin`` folder contains some
wrapper scripts that present as simple compilers and linkers, but wrap
underlying calls to ``xcrun``. This allows configure to use a ``CC``
definition without spaces, and without user- or version-specific paths, while
retaining the ability to adapt to the local Xcode install. These scripts are
included in the ``bin`` directory of an iOS install.

The path has also been cleared of any user customizations. A common source of
bugs is for tools like Homebrew to accidentally leak macOS binaries into an iOS
Expand Down Expand Up @@ -139,8 +146,8 @@ the binary libraries that CPython depends on (XZ, BZip2, LibFFI and OpenSSL).
This can be done by defining the ``LIBLZMA_CFLAGS``, ``LIBLZMA_LIBS``,
``BZIP2_CFLAGS``, ``BZIP2_LIBS``, ``LIBFFI_CFLAGS``, and ``LIBFFI_LIBS``
environment variables, and the ``--with-openssl`` configure option. Versions of
these libraries pre-compiled for iOS can be found in [this
repository](https://github.com/beeware/cpython-apple-source-deps/releases).
these libraries pre-compiled for iOS can be found in `this repository
<https://github.com/beeware/cpython-apple-source-deps/releases>`__.

By default, Python will be compiled with an iOS deployment target (i.e., the
minimum supported iOS version) of 12.0. To specify a different deployment
Expand Down