Upgrade Guide

#High Impact Changes

• New package name nativephp/desktop
• Root namespace updated to Native\Desktop
• Dropped macOS Catalina and Big Sur support

#Medium Impact Changes

• Serve command renamed
• Node integration disabled by default

#Low Impact Changes

• Modifying the Electron backend
• [New build output location][#new-dist-location]

#Upgrading To 2.0 From 1.x

NativePHP for Desktop v2 is a significant architecture overhaul and security release. The package has moved to a new repository with a new name: nativephp/desktop. Please replace nativephp/electron in your composer.json with the new package.

"require": {
    "nativephp/electron": "^1.3", 
    "nativephp/laravel": "^1.3", 
    "nativephp/desktop": "^2.0" 
}

If you're requiring nativephp/laravel as well, please remove that too.

Then update the package:

composer update
php artisan native:install

After installation, the native:install script will be automatically registered as a post-update-cmd, so you won't have to manually run it after a composer update.

#Update class imports

With the package rename, the root namespace has also changed. Please update all occurrences of Native\Laravel to Native\Desktop.

use Native\Laravel\Facades\Window; 
use Native\Desktop\Facades\Window; 

#macOS support

v2 drops support for macOS Catalina and Big Sur. This change comes from the Electron v38 upgrade and aligns with Apple's supported OS versions. Most users should be unaffected, but please check your deployment targets before upgrading.

• Electron Catalina support dropped
• Electron Big Sur support dropped

#Renamed native:serve command

The artisan native:serve command has been deprecated and renamed to artisan native:run for better symmetry with the mobile package. Please update the composer native:dev script to reference the new run command.

#New dist location

The build output has moved to nativephp/electron/dist

#Security defaults

nodeIntegration is now disabled by default. While this improves security, it may affect applications that rely on this functionality. You can easily re-enable it using Window::webPreferences() where needed.

#Modifying the Electron backend

If you need to make any specific adjustments to the underlying Electron app, you can publish it using php artisan native:install --publish. This will export the Electron project to {project-root}/nativephp/electron and allow you to fully control all of NativePHP's inner workings.

Additionally, this will modify your post-update-cmd script to keep your project up to date, but note that you may need to cherry-pick any adjustments you've made after a composer update.