环境设置

系统要求

1. PHP 8.3+
2. Laravel 11+

如果你的机器上还没有安装 PHP，在 Mac 和 Windows 上最简单的方式是使用 Laravel Herd。它快速且免费！

iOS 要求

注意！

你只能在 Mac 上编译 iOS 应用。这是 Apple 强制的限制。但我们通过 Bifrost 为你提供了解决方案！

1. macOS（必需 - iOS 开发只能在 Apple silicon Mac 上进行，M1+）
2. Xcode 16.0 或更高版本
3. Xcode 命令行工具
4. Homebrew 和 CocoaPods
5. 可选 用于测试的 iOS 设备

设置 iOS 开发环境

1. 安装 Xcode

   • 从 Mac App Store 下载
   • 最低版本：Xcode 16.0

2. 安装 Xcode 命令行工具

   xcode-select --install

   验证安装：

   xcode-select -p

3. 安装 Homebrew（如果尚未安装）

   /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

4. 安装 CocoaPods

   brew install cocoapods

   验证安装：

   pod --version

Apple 开发者账号

你不需要注册 Apple Developer Program（$99/年）就可以在模拟器上开发和测试应用。但是，当你想要以下操作时需要注册：

• 在真实设备上测试应用
• 通过 App Store 分发应用
• 测试依赖付费 Apple 开发者账号的功能，如推送通知

Android 要求

1. Android Studio 2024.2.1 或更高版本
2. API 33 或更高版本的 Android SDK
3. 仅限 Windows：必须安装 7zip。

JDK 版本兼容性

你可能需要单独安装 Java Development Kit (JDK)。最新版本的 Android Studio 不再自动安装它。 如果遇到 Gradle 错误，请查看 Gradle JDK 兼容性矩阵。 最新的 JDK 版本可能尚不支持。

要检查已安装的 Gradle 版本，请在运行 php artisan native:install 后检查 nativephp/android/.gradle 文件夹。

设置 Android Studio 和 SDK

1. 下载并安装 Android Studio

   • 从 Android Studio 下载页面 下载
   • 最低要求版本：Android Studio 2024.2.1

2. 安装 Android SDK

   • 打开 Android Studio
   • 导航到 Tools → SDK Manager
   • 在 SDK Platforms 选项卡中，安装至少一个 API 33 或更高版本的 Android SDK 平台
     • 最新稳定版本：Android 15 (API 35)
     • 你只需要安装一个 API 版本即可开始
   • 在 SDK Tools 选项卡中，确保 Android SDK Build-Tools 和 Android SDK Platform-Tools 已安装

就这样！Android Studio 会自动处理所有必要的配置。

为 NativePHP 做准备

1. 确保你可以在终端中运行 java -version 和 adb devices。
2. 设置以下环境变量：

在 macOS 上

# 如果 JAVA_HOME 已在环境变量中设置（使用 `printenv | grep JAVA_HOME` 检查），则不需要此设置
export JAVA_HOME=$(/usr/libexec/java_home -v 17) 

export ANDROID_HOME=$HOME/Library/Android/sdk
export PATH=$PATH:$JAVA_HOME/bin:$ANDROID_HOME/emulator:$ANDROID_HOME/tools:$ANDROID_HOME/tools/bin:$ANDROID_HOME/platform-tools

在 Windows 上

以下示例假设 Android SDK 和 JDK 使用默认安装路径：

set ANDROID_HOME=C:\Users\yourname\AppData\Local\Android\Sdk
set PATH=%PATH%;%JAVA_HOME%\bin;%ANDROID_HOME%\platform-tools

# 如果 JAVA_HOME 已在 Windows 环境变量中设置，则不需要此设置
set JAVA_HOME=C:\Program Files\Microsoft\jdk-17.0.8.7-hotspot

"No AVDs found" 错误

如果遇到此错误，说明 Android Studio 中没有配置虚拟设备。 要解决此问题，打开 Android Studio，导航到 Virtual Devices，并创建至少一个设备。

在真实设备上测试

你_不需要_物理 iOS/Android 设备来编译和测试应用，因为 NativePHP for Mobile 支持 iOS 模拟器和 Android 模拟器。但是，我们强烈建议你在提交到 Apple App Store 和 Google Play Store 之前在真实设备上测试应用。

在 iOS 上

如果你想在真实 iOS 设备上运行应用，需要确保设备处于开发者模式，并且已作为注册设备添加到你的 Apple 开发者账号中。

在 Android 上

在 Android 上，你需要启用开发者选项并启用 USB 调试 (ADB)。