安装

安装 Composer 包

NativePHP 包含你的应用程序与 iOS 和 Android 协作所需的所有库、类、命令和接口。只需一个命令即可安装：

composer require nativephp/mobile

我们热爱 Laravel

NativePHP for Mobile 专为 Laravel 构建。我们建议你将其安装到新的 Laravel 应用程序中来创建你的 NativePHP 应用。

Windows 用户注意事项

Windows Defender

将 C:\temp 以及你的项目文件夹添加到 Windows Defender 排除列表中，可以显著加快应用编译期间的 Composer 安装速度。这可以防止实时扫描处理构建过程中创建的大量临时文件，从而避免显著拖慢进程。

不支持 WSL

NativePHP 不能在 WSL（Windows Subsystem for Linux）中运行。你必须直接在 Windows 上安装和运行 NativePHP。

运行 NativePHP 安装程序

在运行 install 命令之前，需要在 .env 中设置以下变量：

NATIVEPHP_APP_ID=com.yourcompany.yourapp
NATIVEPHP_APP_VERSION="DEBUG"
NATIVEPHP_APP_VERSION_CODE="1"

在配置中了解更多关于这些选项的信息。

设置 Apple 开发者团队 ID

设置你的开发团队可能很有用。你可以通过 .env 文件来设置。你的开发团队 ID 可以在 Apple Developer 账号的“Membership details”下找到。

NATIVEPHP_DEVELOPMENT_TEAM={your team ID}

php artisan native:install

NativePHP 安装程序会负责设置和配置你的 Laravel 应用程序，使其能够与 iOS 和 Android 协作。

你可能会被询问是否要安装启用 ICU 的 PHP 二进制文件。如果你的应用程序依赖 intl PHP 扩展，则应该安装这些文件。

如果你不需要 intl 或不确定，请选择默认的非 ICU 构建版本。

计划使用 Filament？

Filament 需要 intl 支持，因此你需要支持 ICU 的二进制文件。

nativephp 目录

运行 php artisan native:install 后，你会在 Laravel 项目的根目录下看到一个新的 nativephp 目录以及一个 config/nativephp.php 配置文件。

nativephp 文件夹包含为目标平台构建应用所需的原生应用程序项目文件。

在正常情况下，你不需要手动打开或编辑任何原生项目文件。NativePHP 会为你处理繁重的工作。

你应该将此目录视为临时目录。 升级 NativePHP 包时，需要运行 php artisan native:install --force，这将完全重建此目录，删除其中的所有文件。

因此，我们也建议你将 nativephp 文件夹添加到 .gitignore。

启动你的应用

注意！ 在原生环境中启动应用之前，先尝试在浏览器中运行它。你可能会遇到需要解决的异常，然后才能原生运行你的应用，而且在原生环境中这些问题可能更难发现。

准备好后：

php artisan native:run

只需按照提示操作！这将开始编译你的应用程序，并在你选择的设备上启动它。

在真实设备上运行

在 iOS 上

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

在 Android 上

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

就是这样！你现在应该可以看到你的 Laravel 应用程序作为原生应用运行了！🎉