如何在Windows操作系统上安装p4a及其相关依赖项

p4a原生不支持直接在Windows裸机运行，以下为目前最稳定的WSL2环境安装方案，若不使用WSL也可安装VMware/VirtualBox虚拟机跑Ubuntu系统，后续操作步骤完全一致：

1. 前置WSL2环境部署 #

• 按下Win+X选择「终端(管理员)」，依次执行两条命令开启Windows相关功能：

  dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart
  

  dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart
  

  执行完成后重启电脑。
• 重启后再次打开管理员终端，设置WSL默认版本为2：wsl --set-default-version 2，之后前往微软商店安装Ubuntu 22.04 LTS，启动后按提示设置用户名和密码即可。

2. WSL内系统基础依赖安装 #

• 先更新软件源：sudo apt update && sudo apt upgrade -y
• 安装p4a依赖的系统组件：sudo apt install -y build-essential git zlib1g-dev python3 python3-pip python3-venv openjdk-17-jdk unzip ant ccache autoconf libtool libssl-dev libffi-dev
• 配置Java环境变量：在~/.bashrc文件末尾添加以下两行：

  export JAVA_HOME=/usr/lib/jvm/java-1.17.0-openjdk-amd64
  export PATH=$JAVA_HOME/bin:$PATH
  

  执行source ~/.bashrc使配置生效，运行java -version能正常输出版本信息即为配置成功。

3. Android SDK与NDK配置 #

• 从Android开发者官方站点下载Linux版最新命令行工具压缩包，放到WSL用户目录下，执行以下命令解压配置：

  mkdir -p ~/Android/cmdline-tools && unzip 下载的压缩包文件名.zip -d ~/Android/cmdline-tools && mv ~/Android/cmdline-tools/cmdline-tools ~/Android/cmdline-tools/latest
  

• 配置Android环境变量：在~/.bashrc文件末尾添加以下两行：

  export ANDROID_HOME=~/Android
  export PATH=$ANDROID_HOME/cmdline-tools/latest/bin:$ANDROID_HOME/platform-tools:$PATH
  

  执行source ~/.bashrc使配置生效。
• 安装对应版本的SDK、构建工具与NDK：sdkmanager "platform-tools" "platforms;android-33" "build-tools;33.0.2" "ndk;25.2.9519653"，中途输入y同意许可协议即可完成安装。
• 配置NDK环境变量：在~/.bashrc文件末尾添加export NDK_HOME=$ANDROID_HOME/ndk/25.2.9519653，执行source ~/.bashrc生效。

4. p4a本体安装 #

• 建议先创建独立虚拟环境避免依赖冲突：python3 -m venv p4a-env && source p4a-env/bin/activate
• 安装p4a：pip install python-for-android
• 验证安装：执行p4a --version，正常输出版本号即为安装成功。

注意：建议把打包项目放在WSL的用户目录下操作，避免跨文件系统的路径权限和IO性能问题。
环境验证可以执行示例打包命令测试：p4a create --package=org.example.testapp --name="TestApp" --version=0.1 --sdk_dir=$ANDROID_HOME --ndk_dir=$NDK_HOME --android_api=33 --ndk_api=21 --requirements=python3,kivy

内容的提问来源于stack exchange，提问作者Vickash Bharttiya