Error in quickstart

[rmiller335]

What were you trying to do?

I am trying to run the minimal app using quickstart instructions. I have PHP8.3 installed, and I found that I had to require the qr-code module after the install. That gets me to the point where I can do a native:jump, and that gives me an error. I also tries a native:run and that also gives an error.

What happened?

native:jump gives me this error on my android phone ...

DEBUG: Fatal error: Illuminate\Routing\urlgenerator::__construct(): Argument #2 ($request) must be of type Illuminate\Http\Request, null given, called in /data/data/com.bifrosttech.jump/app_projects/laravel/laravel/vendor/laravel/framework/src/Illuminate/Routing/RoutingServiceProvider.php on line 63 DEBUG: Error type: TypeError DEBUG: Trace: #0 /data/data/com.bifrosttech.jump/app_projects/laravel/laravel/vendor/laravel/framework/src/Illuminate/Routing/RoutingServiceProvider.php(63): Illuminate\Routing\UrlGenerator->__construct(Object(Illuminate\Routing\RouteCollection), NULL, 'http://127.0.0....') #1 /data/data/com.bifrosttech.jump/app_projects/laravel/laravel/vendor/laravel/framework/src/Illuminate/Container/Container.php(1115): Illuminate\Routing\RoutingServiceProvider->{closure:Illuminate\Routing\RoutingServiceProvider::registerUrlGenerator():55}(Object(Illuminate\Foundation\Application), Array) #2 /data/data/com.bifrosttech.jump/app_projects/laravel/laravel/vendor/laravel/framework/src/Illuminate/Container/Container.php(933): Illuminate\Container\Container->build(Object(Closure)) #3 /data/data/com.bifrosttech.jump/app_projects/laravel/laravel/vendor/laravel/framework/src/Illuminate/Foundation/Application.php(1078): Illuminate\Container\Container->resolve('url', Array, true) #4 /data/data/com.bifrosttech.jump/app_projects/laravel/laravel/vendor/laravel/framework/src/Illuminate/Container/Container.php(864): Illuminate\Foundation\Application->resolve('url', Array) #5 /data/data/com.bifrosttech.jump/app_projects/laravel/laravel/vendor/laravel/framework/src/Illuminate/Foundation/Application.php(1058): Illuminate\Container\Container->make('url', Array) #6 /data/data/com.bifrosttech.jump/app_projects/laravel/laravel/vendor/laravel/framework/src/Illuminate/Container/Container.php(1805): Illuminate\Foundation\Application->make('url') #7 /data/data/com.bifrosttech.jump/app_projects/laravel/laravel/vendor/laravel/framework/src/Illuminate/Support/Facades/Facade.php(240): Illuminate\Container\Container->offsetGet('url') #8 /data/data/com.bifrosttech.jump/app_projects/laravel/laravel/vendor/laravel/framework/src/Illuminate/Support/Facades/Facade.php(211): Illuminate\Support\Facades\facade::resolveFacadeInstance('url') #9 /data/data/com.bifrosttech.jump/app_projects/laravel/laravel/vendor/laravel/framework/src/Illuminate/Support/Facades/Facade.php(357): Illuminate\Support\Facades\facade::getFacadeRoot() #10 /data/data/com.bifrosttech.jump/app_projects/laravel/laravel/app/Providers/AppServiceProvider.php(23): Illuminate\Support\Facades\facade::__callStatic('forceHttps', Array) #11 /data/data/com.bifrosttech.jump/app_projects/laravel/laravel/vendor/laravel/framework/src/Illuminate/Container/BoundMethod.php(36): App\Providers\AppServiceProvider->boot() #12 /data/data/com.bifrosttech.jump/app_projects/laravel/laravel/vendor/laravel/framework/src/Illuminate/Container/Util.php(43): Illuminate\Container\BoundMethod::{closure:Illuminate\Container\BoundMethod::call():35}() #13 /data/data/com.bifrosttech.jump/app_projects/laravel/laravel/vendor/laravel/framework/src/Illuminate/Container/BoundMethod.php(96): Illuminate\Container\util::unwrapIfClosure(Object(Closure)) #14 /data/data/com.bifrosttech.jump/app_projects/laravel/laravel/vendor/laravel/framework/src/Illuminate/Container/BoundMethod.php(35): Illuminate\Container\boundmethod::callBoundMethod(Object(Illuminate\Foundation\Application), Array, Object(Closure)) #15 /data/data/com.bifrosttech.jump/app_projects/laravel/laravel/vendor/laravel/framework/src/Illuminate/Container/Container.php(799): Illuminate\Container\boundmethod::call(Object(Illuminate\Foundation\Application), Array, Array, NULL) #16 /data/data/com.bifrosttech.jump/app_projects/laravel/laravel/vendor/laravel/framework/src/Illuminate/Foundation/Application.php(1151): Illuminate\Container\Container->call(Array) #17 /data/data/com.bifrosttech.jump/app_projects/laravel/laravel/vendor/laravel/framework/src/Illuminate/Foundation/Application.php(1132): Illuminate\Foundation\Application->bootProvider(Object(App\Providers\AppServiceProvider)) #18 [internal function]: Illuminate\Foundation\Application->{closure:Illuminate\Foundation\Application::boot():1131}(Object(App\Providers\AppServiceProvider), 'App\Providers\A...') #19 /data/data/com.bifrosttech.jump/app_projects/laravel/laravel/vendor/laravel/framework/src/Illuminate/Foundation/Application.php(1131): array_walk(Array, Object(Closure)) #20 /data/data/com.bifrosttech.jump/app_projects/laravel/laravel/vendor/laravel/framework/src/Illuminate/Foundation/Bootstrap/BootProviders.php(17): Illuminate\Foundation\Application->boot() #21 /data/data/com.bifrosttech.jump/app_projects/laravel/laravel/vendor/laravel/framework/src/Illuminate/Foundation/Application.php(342): Illuminate\Foundation\Bootstrap\BootProviders->bootstrap(Object(Illuminate\Foundation\Application)) #22 /data/data/com.bifrosttech.jump/app_projects/laravel/laravel/vendor/laravel/framework/src/Illuminate/Foundation/Http/Kernel.php(186): Illuminate\Foundation\Application->bootstrapWith(Array) #23 /data/data/com.bifrosttech.jump/app_projects/laravel/laravel/native.php(35): Illuminate\Foundation\Http\Kernel->bootstrap() #24 {main}

native:run gives me this:

rmiller@bruno:~/dev/nphp-play$ ./artisan native:run

Running NativePHP for Android

PHP 8.3.30 is available (installed: 8.3). Run php artisan native:install --force to update.

Build log: /home/rmiller/dev/nphp-play/nativephp/android-build.log

• daemon not running; starting now at tcp:5037
• daemon started successfully
  No devices found. Attempting to launch an emulator...

┌ Select an emulator to launch ────────────────────────────────┐
│ Medium_Phone_API_36.1 │
└──────────────────────────────────────────────────────────────┘

Waiting for emulator to boot .......................................................... 11s DONE
Updating Android configuration .................................................... 17.96ms DONE
Copying Laravel source ................................................................. 2s DONE
Installing Composer dependencies ....................................................... 4s DONE
Optimizing autoloader .................................................................. 4s DONE
Creating bundle archive ................................................................ 5s DONE
Bundle size ........................................................................... 41.79 MB
Build type ............................................................................... debug
App version .............................................................................. DEBUG

Welcome to Gradle 8.13!

Here are the highlights of this release:

• Daemon JVM auto-provisioning
• Enhancements for Scala plugin and JUnit testing
• Improvements for build authors and plugin developers

For more details see https://docs.gradle.org/8.13/release-notes.html

Starting a Gradle Daemon (subsequent builds will be faster)

Configure project :app
WARNING: The following problems were found when resolving the SDK location:
Where: sdk.dir property in local.properties file. Problem: Set with empty value

Task :app:processDebugResources FAILED

FAILURE: Build failed with an exception.

• What went wrong:
  Execution failed for task ':app:processDebugResources'.

A failure occurred while executing com.android.build.gradle.internal.res.LinkApplicationAndroidResourcesTask$TaskAction
Android resource linking failed
ERROR: /home/rmiller/dev/nphp-play/nativephp/android/app/build/intermediates/packaged_manifests/debug/processDebugManifestForPackage/androidmanifest.xml:2: AAPT: error: attribute 'package' in tag is not a valid Android package name: 'com.rmiller.nphp-play'.

• Try:

Run with --stacktrace option to get the stack trace.
Run with --info or --debug option to get more log output.
Run with --scan to get full insights.
Get more help at https://help.gradle.org/.

BUILD FAILED in 1m 27s
27 actionable tasks: 27 executed
Gradle build failed

Check the build log for details: /home/rmiller/dev/nphp-play/nativephp/android-build.log

⚡ BIFROST

Ship to App Store & Play Store in one click

✓ Certificates & provisioning profiles — handled
✓ Code signing for iOS & Android — automated
✓ Direct uploads to both stores — one command

→ bifrost.nativephp.com

android-build.log

How to reproduce the bug

Follow quickstart instructions

Debug Output

INFO NativePHP Mobile.

+--------------------+-------------------+
| Package Version | 3.2.2 |
| PHP Version (Host) | 8.3.6 |
| OS | Linux |
| OS Version | 6.8.0-107-generic |
| Embedded PHP | 8.3 |
+--------------------+-------------------+

INFO Installed Plugins.

None

INFO Development Tools.

+----------------+--------------------------------------+
| Android Studio | Not found |
| Gradle | Gradle 8.13 |
| Java | openjdk version "17.0.18" 2026-01-20 |
+----------------+--------------------------------------+

Which operating systems have you seen this occur on?

Linux

Which platforms were you trying to build for?

Android (Emulator)

Notes

No response

[simonhamp]

Here's the problem:

attribute 'package' in tag is not a valid Android package name: 'com.rmiller.nphp-play'.

Android app IDs cannot contain dashes -; they can only contain alphanumerics and underscores.

Make this change this in your .env and re-run the build:

-NATIVEPHP_APP_ID=com.rmiller.nphp-play
+NATIVEPHP_APP_ID=com.rmiller.nphp_play

[rmiller335]

Okay, I made that change. Now native:jump displays this on the console:

rmiller@bruno:~/dev/nphp-play$ ./artisan native:run

  Running NativePHP for Android

 PHP 8.3.30 is available (installed: 8.3). Run php artisan native:install --force to update.

 Build log: /home/rmiller/dev/nphp-play/nativephp/android-build.log

 No devices found. Attempting to launch an emulator...

 ┌ Select an emulator to launch ────────────────────────────────┐
 │ Medium_Phone_API_36.1                                        │
 └──────────────────────────────────────────────────────────────┘

  Waiting for emulator to boot ........................................................... 3s DONE
  Updating Android configuration ..................................................... 5.57ms DONE
  Copying Laravel source ................................................................. 1s DONE
  Installing Composer dependencies ....................................................... 3s DONE
  Optimizing autoloader .................................................................. 3s DONE
  Creating bundle archive ................................................................ 5s DONE
  Bundle size ........................................................................... 41.79 MB
  Build type ............................................................................... debug
  App version .............................................................................. DEBUG


BUILD SUCCESSFUL in 4s
40 actionable tasks: 5 executed, 35 up-to-date
  App launched!


  ⚡ BIFROST

  Ship to App Store & Play Store in one click

  ✓ Certificates & provisioning profiles — handled
  ✓ Code signing for iOS & Android — automated
  ✓ Direct uploads to both stores — one command

  → bifrost.nativephp.com

rmiller@bruno:~/dev/nphp-play$ ./artisan native:jump

  NativePHP Jump Server

 ┌ Select target platform ──────────────────────────────────────┐
 │ Android                                                      │
 └──────────────────────────────────────────────────────────────┘

  Building assets for android ............................................................ 2s DONE
  Cleaning up 1 existing server(s) ................................................. 501.12ms DONE

 ┌ Multiple network interfaces detected. Select the IP for the QR code ┐
 │ 10.10.22.101                                                        │
 └─────────────────────────────────────────────────────────────────────┘

  Copying files .......................................................................... 1s DONE
  Creating zip archive ................................................................... 6s DONE
  Bundle created ........................................................................ 52.66 MB
  Server running ............................................................ Press Ctrl+C to stop
  Device ................................................... Unknown device downloading (52.66 MB)
  Device ............................................. moto g stylus - 2025 downloading (52.66 MB)
  Device ................................................... Unknown device downloading (52.66 MB)

... and on the phone I get:

DEBUG: Fatal error: Illuminate\Routing\UrlGenerator::__construct(): Argument #2 ($request) must be of type Illuminate\Http\Request, null given, called in /data/data/com.bifrosttech.jump/app_projects/laravel/laravel/vendor/laravel/framework/src/Illuminate/Routing/RoutingServiceProvider.php on line 63 DEBUG: Error type: TypeError DEBUG: Trace: #0 /data/data/com.bifrosttech.jump/app_projects/laravel/laravel/vendor/laravel/framework/src/Illuminate/Routing/RoutingServiceProvider.php(63): Illuminate\Routing\UrlGenerator->__construct(Object(Illuminate\Routing\RouteCollection), NULL, '[http://127.0.0](http://127.0.0.0/)....') #1 /data/data/com.bifrosttech.jump/app_projects/laravel/laravel/vendor/laravel/framework/src/Illuminate/Container/Container.php(1115): Illuminate\Routing\RoutingServiceProvider->{closure:Illuminate\Routing\RoutingServiceProvider::registerUrlGenerator():55}(Object(Illuminate\Foundation\Application), Array) #2 /data/data/com.bifrosttech.jump/app_projects/laravel/laravel/vendor/laravel/framework/src/Illuminate/Container/Container.php(933): Illuminate\Container\Container->build(Object(Closure)) #3 /data/data/com.bifrosttech.jump/app_projects/laravel/laravel/vendor/laravel/framework/src/Illuminate/Foundation/Application.php(1078): Illuminate\Container\Container->resolve('url', Array, true) #4 /data/data/com.bifrosttech.jump/app_projects/laravel/laravel/vendor/laravel/framework/src/Illuminate/Container/Container.php(864): Illuminate\Foundation\Application->resolve('url', Array) #5 /data/data/com.bifrosttech.jump/app_projects/laravel/laravel/vendor/laravel/framework/src/Illuminate/Foundation/Application.php(1058): Illuminate\Container\Container->make('url', Array) #6 /data/data/com.bifrosttech.jump/app_projects/laravel/laravel/vendor/laravel/framework/src/Illuminate/Container/Container.php(1805): Illuminate\Foundation\Application->make('url') #7 /data/data/com.bifrosttech.jump/app_projects/laravel/laravel/vendor/laravel/framework/src/Illuminate/Support/Facades/Facade.php(240): Illuminate\Container\Container->offsetGet('url') #8 /data/data/com.bifrosttech.jump/app_projects/laravel/laravel/vendor/laravel/framework/src/Illuminate/Support/Facades/Facade.php(211): Illuminate\Support\Facades\Facade::resolveFacadeInstance('url') #9 /data/data/com.bifrosttech.jump/app_projects/laravel/laravel/vendor/laravel/framework/src/Illuminate/Support/Facades/Facade.php(357): Illuminate\Support\Facades\Facade::getFacadeRoot() #10 /data/data/com.bifrosttech.jump/app_projects/laravel/laravel/app/Providers/AppServiceProvider.php(23): Illuminate\Support\Facades\Facade::__callStatic('forceHttps', Array) #11 /data/data/com.bifrosttech.jump/app_projects/laravel/laravel/vendor/laravel/framework/src/Illuminate/Container/BoundMethod.php(36): App\Providers\AppServiceProvider->boot() #12 /data/data/com.bifrosttech.jump/app_projects/laravel/laravel/vendor/laravel/framework/src/Illuminate/Container/Util.php(43): Illuminate\Container\BoundMethod::{closure:Illuminate\Container\BoundMethod::call():35}() #13 /data/data/com.bifrosttech.jump/app_projects/laravel/laravel/vendor/laravel/framework/src/Illuminate/Container/BoundMethod.php(96): Illuminate\Container\Util::unwrapIfClosure(Object(Closure)) #14 /data/data/com.bifrosttech.jump/app_projects/laravel/laravel/vendor/laravel/framework/src/Illuminate/Container/BoundMethod.php(35): Illuminate\Container\BoundMethod::callBoundMethod(Object(Illuminate\Foundation\Application), Array, Object(Closure)) #15 /data/data/com.bifrosttech.jump/app_projects/laravel/laravel/vendor/laravel/framework/src/Illuminate/Container/Container.php(799): Illuminate\Container\BoundMethod::call(Object(Illuminate\Foundation\Application), Array, Array, NULL) #16 /data/data/com.bifrosttech.jump/app_projects/laravel/laravel/vendor/laravel/framework/src/Illuminate/Foundation/Application.php(1151): Illuminate\Container\Container->call(Array) #17 /data/data/com.bifrosttech.jump/app_projects/laravel/laravel/vendor/laravel/framework/src/Illuminate/Foundation/Application.php(1132): Illuminate\Foundation\Application->bootProvider(Object(App\Providers\AppServiceProvider)) #18 [internal function]: Illuminate\Foundation\Application->{closure:Illuminate\Foundation\Application::boot():1131}(Object(App\Providers\AppServiceProvider), 'App\\Providers\\A...') #19 /data/data/com.bifrosttech.jump/app_projects/laravel/laravel/vendor/laravel/framework/src/Illuminate/Foundation/Application.php(1131): array_walk(Array, Object(Closure)) #20 /data/data/com.bifrosttech.jump/app_projects/laravel/laravel/vendor/laravel/framework/src/Illuminate/Foundation/Bootstrap/BootProviders.php(17): Illuminate\Foundation\Application->boot() #21 /data/data/com.bifrosttech.jump/app_projects/laravel/laravel/vendor/laravel/framework/src/Illuminate/Foundation/Application.php(342): Illuminate\Foundation\Bootstrap\BootProviders->bootstrap(Object(Illuminate\Foundation\Application)) #22 /data/data/com.bifrosttech.jump/app_projects/laravel/laravel/vendor/laravel/framework/src/Illuminate/Foundation/Http/Kernel.php(186): Illuminate\Foundation\Application->bootstrapWith(Array) #23 /data/data/com.bifrosttech.jump/app_projects/laravel/laravel/native.php(35): Illuminate\Foundation\Http\Kernel->bootstrap() #24 {main}

[krixnaas]

//AppServiceProvider.php

public function boot(): void
{
// Only force HTTPS if the app is NOT running in the console (CLI)
// This allows NativePHP to boot internally using HTTP on 127.0.0.1
if (!app()->runningInConsole()) {
URL::forceScheme('https');
}
}

Solved the issue.

[rmiller335]

That did it, thanks.

[shanerbaner82]

What is the APP_URL in your .env set to?