Basic steps to build and run an Android project generated by `pn`.

`pn run android` unpacks the bundled Android template (Kotlin + Chaquopy) into `build/android/android_template` and copies your `app/` into the template's `app/src/main/python/app/`.

No network is required for the template itself; the template zip is bundled with the package.

pn run android

Or to only prepare the project without building:

pn run android --prepare-only

This will stage files under `build/android/android_template` so you can open it in Android Studio if you prefer.

Basic steps to build and run an iOS project generated by `pn`.

`pn run ios` unpacks the bundled iOS template (Swift + PythonKit, with optional Rubicon-ObjC) into `build/ios/ios_template` and copies your `app/` under `build/ios/app/` for later integration steps. The template zip is bundled with the package, so no network is required to scaffold.

The default `ViewController.swift` initializes PythonKit, prints the Python version, and attempts to import `rubicon.objc` if present.

pn run ios

Or prepare without building:

pn run ios --prepare-only

You can then open `build/ios/ios_template/ios_template.xcodeproj` in Xcode.

[tool.setuptools]

license-files = ["LICENSE*"]

[tool.setuptools.data-files]

"pythonnative/templates" = [

"templates/android_template.zip",

"templates/ios_template.zip",

]

[tool.ruff]

target-version = "py39"

line-length = 120

import shutil

import subprocess

import sys

import sysconfig

import zipfile

from importlib import resources

# Try to load from installed package resources first (if templates are packaged inside the module)

try:

cand = resources.files("pythonnative").joinpath("templates").joinpath(zip_name)

with resources.as_file(cand) as p:

resource_path = str(p)

if os.path.exists(resource_path):

_extract_zip_to_destination(resource_path, destination)

return

except Exception:

# Not packaged inside the module; try data-files installation locations next

pass

# Try sysconfig data dir (where data-files are typically installed)

try:

data_dir = sysconfig.get_paths().get("data")

if data_dir:

candidate = os.path.join(data_dir, "pythonnative", "templates", zip_name)

if os.path.exists(candidate):

_extract_zip_to_destination(candidate, destination)

return

except Exception:

pass

# Try site-packages purelib/platlib (some environments place data files here)

try:

purelib = sysconfig.get_paths().get("purelib")

platlib = sysconfig.get_paths().get("platlib")

for base in filter(None, [purelib, platlib]):

candidate = os.path.join(base, "pythonnative", "templates", zip_name)

if os.path.exists(candidate):

_extract_zip_to_destination(candidate, destination)

return

except Exception:

pass

# Fallback: use repository-level templates directory

# Determine the platform

platform: str = args.platform

prepare_only: bool = getattr(args, "prepare_only", False)

# Define the build directory

build_dir: str = os.path.join(os.getcwd(), "build", platform)

shutil.copytree(src_dir, dest_dir, dirs_exist_ok=True)

# Install any necessary Python packages into the project environment

# Skip installation during prepare-only to avoid network access and speed up scaffolding

if not prepare_only:

requirements_path = os.path.join(os.getcwd(), "requirements.txt")

if os.path.exists(requirements_path):

subprocess.run([sys.executable, "-m", "pip", "install", "-r", requirements_path], check=False)

# Run the project

if prepare_only:

print("Prepared project in build/ without building (prepare-only).")

return

if platform == "android":

# Change to the Android project directory

android_project_dir: str = os.path.join(build_dir, "android_template")

# Create a new command 'run' that calls run_project

parser_run = subparsers.add_parser("run")

parser_run.add_argument("platform", choices=["android", "ios"])

parser_run.add_argument(

"--prepare-only",

action="store_true",

help="Extract templates and stage app without building",

)

parser_run.set_defaults(func=run_project)

# Create a new command 'clean' that calls clean_project

//

import UIKit

import PythonKit

class ViewController: UIViewController {

override func viewDidLoad() {

super.viewDidLoad()

// Minimal PythonKit bootstrap: print Python version and attempt to import Rubicon.

let sys = Python.import("sys")

print("Python Version: \(sys.version_info.major).\(sys.version_info.minor)")

print("Python Path: \(sys.path)")

// Try to import Rubicon-ObjC if available. Safe no-op if not present.

do {

let rubiconObjC = try Python.attemptImport("rubicon.objc")

let ObjCClass = rubiconObjC.ObjCClass

print("Rubicon available: \(ObjCClass)")

} catch {

print("Rubicon not available; continuing without it.")

}

}

assert not os.path.exists(os.path.join(tmpdir, "build"))

finally:

shutil.rmtree(tmpdir, ignore_errors=True)

def test_cli_run_prepare_only_android_and_ios():

tmpdir = tempfile.mkdtemp(prefix="pn_cli_test_")

try:

# init to create app scaffold

result = run_pn(["init", "MyApp"], tmpdir)

assert result.returncode == 0, result.stderr

# prepare-only android

result = run_pn(["run", "android", "--prepare-only"], tmpdir)

assert result.returncode == 0, result.stderr

assert os.path.isdir(os.path.join(tmpdir, "build", "android", "android_template"))

# prepare-only ios

result = run_pn(["run", "ios", "--prepare-only"], tmpdir)

assert result.returncode == 0, result.stderr

assert os.path.isdir(os.path.join(tmpdir, "build", "ios", "ios_template"))

finally:

shutil.rmtree(tmpdir, ignore_errors=True)