Crie seu primeiro projeto com NativePHP

Olá a todos, se chegou até aqui, suponho que já tenha acompanhado as lições anteriores. Caso contrário, volte e confira nosso guia anterior primeiro: Iniciando com o NativePHP – Instalando o Laravel – FoxDevelop. Agora vamos construir nosso primeiro projeto passo a passo.

Vamos começar do zero e configurar um projeto totalmente novo:

Crie uma pasta vazia em seu computador para armazenar os arquivos do projeto, por exemplo: D:\phpproject

Abrir o CMD diretamente nesse diretório: digite cmd na barra de endereço da pasta e pressione Enter; a janela de comando abrirá e trocará o caminho automaticamente.

Execute os comandos abaixo:

composer create-project --prefer-dist nativephp/mobile-starter my-app
cd my-app
php artisan native:jump

Observação rápida sobre solução de problemas (pule essa seção se estiver usando o 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)

Esse erro ocorre porque a versão local do PHP é a 8.2; é necessário atualizar para o PHP 8.3 para continuar.

https://windows.php.net/download#php-8.3

Acesse essa página para baixar o PHP 8.3. Usuários do Windows 64 bits podem baixar diretamente o pacote abaixo:

https://downloads.php.net/~windows/releases/archives/php-8.3.31-nts-Win32-vs16-x64.zip

Após o download, extraia todos os arquivos para D:\php8.3. Você pode escolher outro caminho de pasta, mas utilize apenas caracteres em inglês.

Após a extração, renomeie o arquivo de configuração:
Altere php.ini-development para php.ini

Abra o arquivo php.ini e remova os comentários excluindo os pontos e vírgulas no início das linhas;

Remova os comentários com ponto e vírgula de todos os itens listados aqui (etapa essencial):

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)

Atualize as variáveis de ambiente do sistema, troque o caminho antigo D:\php8.2 por D:\php8.3.

Verifique a instalação do PHP com o comando php -v; se a versão estiver correta, retorne à configuração do projeto.

Retomando a criação do projeto NativePHP Mobile

Agora execute os comandos de instalação novamente:

composer create-project --prefer-dist nativephp/mobile-starter my-app
cd my-app

Uma instalação bem-sucedida não exibirá mensagens de erro em vermelho no terminal.

Para testar em um celular físico, conecte o dispositivo ao computador via USB primeiro e ative as Opções de Desenvolvedor e a Depuração USB no aparelho.

Utilize o comando a seguir para teste rápido em dispositivo físico (Início rápido em dispositivo real: Instale o aplicativo Jump no celular e escaneie o código QR para se conectar e depurar, sem necessidade de compilar o APK completo):

php artisan native:jumpCode language: CSS (css)

Se não tiver um dispositivo móvel físico, use o comando alternativo abaixo para testar no emulador:

php artisan native:serve : Para visualização em área de trabalho ou teste em emulador (abre uma janela de aplicativo independente em seu computador)

Quando tudo estiver funcionando corretamente, você verá uma saída semelhante ao exemplo abaixo após executar php artisan native:jump

php artisan native:jump

Servidor NativePHP Jump

Servidor Laravel ……………………………………………………………………. http://127.0.0.1:8000
Inicialização do Laravel ………………………………………………………………… concluída em 0,42s (HTTP 200)

Acesse http://127.0.0.1:8000 no navegador para visualizar o conteúdo do aplicativo em execução.