안녕하세요. 이 부분까지 오셨다면 이전 강의를 모두 학습하신 것으로 보입니다. 아직 학습하지 않으셨다면 먼저 이전 가이드를 확인해 주세요: NativePHP 시작하기 – Laravel 설치 – FoxDevelop. 이제 첫 프로젝트를 제작하는 과정을 단계별로 알아보겠습니다.
처음부터 새 프로젝트를 설정해 보겠습니다.
PC에 프로젝트 파일을 저장할 빈 폴더를 생성하세요. 예시: D:\phpproject
폴더 주소 표시줄에 cmd를 입력하고 Enter 키를 누르면 해당 경로로 CMD가 자동 실행됩니다.
아래 명령어를 실행하세요.
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로 기기를 PC에 연결한 후, 휴대폰에서 개발자 옵션과 USB 디버깅을 활성화하세요.
아래 명령어로 실제 기기에서 빠르게 테스트할 수 있습니다 (실기 빠른 실행: 휴대폰에 Jump 앱을 설치하고 QR 코드를 스캔해 디버깅에 연결하세요. APK 전체 컴파일은 필요하지 않습니다):
php artisan native:jumpCode language: CSS (css)실제 모바일 기기가 없다면 아래 대체 명령어를 사용해 에뮬레이터에서 테스트하세요.
php artisan native:serve : 데스크톱 미리보기 또는 에뮬레이터 테스트에 사용 (PC에 독립된 앱 창이 실행됨)
모든 기능이 정상 작동한다면 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을 열어 실행 중인 앱 콘텐츠를 확인하세요.
