各位好,如果你來到這個章節,想必已經完成前面的課程。若尚未學習,請先回顧我們先前的教學:NativePHP 快速入門 – 安裝 Laravel – FoxDevelop。接下來我們將一步步建立第一個專案。
我們會從零開始,全新建立一個專案:
在電腦上建立空白資料夾來存放專案檔案,範例:D:\phpproject
快速在此路徑開啟命令提示字元:直接在資料夾網址列輸入 cmd 後按下 Enter,視窗就會自動開啟並切換至該目錄。
執行以下指令:
composer create-project --prefer-dist nativephp/mobile-starter my-app
cd my-app
php artisan native:jump
快速問題排除(若你使用 PHP 8.3 可略過此段落)
composer create-project --prefer-dist nativephp/mobile-starter my-app
Creating a "nativephp/mobile-starter" project at "./my-app"
Installing nativephp/mobile-starter (1.0.4)
- Downloading nativephp/mobile-starter (1.0.4)
- Installing nativephp/mobile-starter (1.0.4): Extracting archive
Created project in D:\phpproject\my-app
> @php -r "file_exists('.env') || copy('.env.example', '.env');"
Loading composer repositories with package information
Updating dependencies
Your requirements could not be resolved to an installable set of packages.
Problem 1
- Root composer.json requires nativephp/mobile ^3.0 -> satisfiable by nativephp/mobile[3.0.0, ..., 3.3.5].
- nativephp/mobile[3.0.0, ..., 3.3.5] require php ^8.3 -> your php version (8.2.31) does not satisfy that requirement.Code language: JavaScript (javascript)
發生此錯誤是因為本機 PHP 版本為 8.2,必須升級至 PHP 8.3 才能繼續作業。
https://windows.php.net/download#php-8.3
前往該網頁下載 PHP 8.3。Windows 64 位元使用者可直接取用下方安裝套件:
https://downloads.php.net/~windows/releases/archives/php-8.3.31-nts-Win32-vs16-x64.zip
下載完成後,將所有檔案解壓縮至 D:\php8.3。你也可以自訂路徑,僅需確認路徑全部使用英文字元即可。
解壓縮完畢後,重新命名設定檔:
將 php.ini-development 更名為 php.ini
開啟 php.ini,刪除開頭的分號以取消註解:
移除以下所有項目的分號註解(此步驟至關重要):
extension_dir = "ext"
extension=curl
extension=gd
extension=mbstring
extension=mysqli
extension=pdo_mysql
extension=zip
extension=openssl
extension=fileinfo
extension=sqlite3
extension=pdo_sqliteCode language: JavaScript (javascript)
更新系統環境變數,將舊的 D:\php8.2 路徑替換為 D:\php8.3。
執行 php -v 確認 PHP 版本,版本無誤後即可繼續建立專案。
繼續建立 NativePHP 行動裝置專案
現在再次執行安裝指令:
composer create-project --prefer-dist nativephp/mobile-starter my-app
cd my-app
安裝成功時,終端機不會出現任何紅色錯誤訊息。
若要在實體手機測試,請先透過 USB 將裝置連接電腦,接著在手機中開啟開發人員選項與 USB 偵錯模式。
使用下方指令快速在實體裝置測試(實機快速啟動:在手機安裝 Jump 應用程式,掃描 QR Code 即可連線偵錯,無需完整編譯 APK):
php artisan native:jumpCode language: CSS (css)
若沒有實體行動裝置,可改用下列指令在模擬器測試:
php artisan native:serve :適用桌面預覽或模擬器測試(會在電腦開啟獨立應用視窗)
執行 php artisan native:jump 且一切正常運作時,你會看到類似以下的執行結果
php artisan native:jump
NativePHP Jump 伺服器
Laravel 伺服器 ……………………………………………………………………. http://127.0.0.1:8000
Laravel 載入完成 ………………………………………………………………… 耗時 0.42 秒 (HTTP 200)
使用瀏覽器開啟 http://127.0.0.1:8000 即可檢視執行中的應用內容。
