Skip to content

Update/upgrade guide #224

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Closed
wants to merge 2 commits into from
Closed

Update/upgrade guide #224

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
bff848e
fix code example formatting
gwleuverink Oct 21, 2025
95c93dc
add breaking change to the Printer object to upgrade guide
gwleuverink Oct 21, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
7 changes: 7 additions & 0 deletions resources/views/docs/desktop/2/getting-started/upgrade-guide.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -13,6 +13,7 @@ order: 1200

- [Serve command renamed](#renamed-codenativeservecode-command)
- [Node integration disabled by default](#security-defaults)
- [Changes to the Printer object](#changes-to-the-codeprintercode-object)

### Low Impact Changes

Expand Down Expand Up @@ -64,6 +65,12 @@ v2 drops support for macOS **_Catalina_** and **_Big Sur_**. This change comes f
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.

## Changes to the `Printer` object

Electron removed the `isDefault` and `status` properties from their `PrinterInfo` object. See their docs regarding this change (here)[https://www.electronjs.org/docs/latest/breaking-changes#removed-isdefault-and-status-properties-on-printerinfo].

To stay in step we had to remove these properties from our `\Native\Desktop\DataObjects\Printer` class as well. If you are using `System::printers()` make sure you are not referencing the `isDefault` and `status` properties.

## New `dist` location

The build output has moved to `nativephp/electron/dist`
Expand Down
7 changes: 5 additions & 2 deletions resources/views/docs/desktop/2/the-basics/system.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -93,8 +93,11 @@ it give you any special privileges to their system.**
You can list all available printers:

```blade
@@use(Native\Desktop\Facades\System) @@foreach(System::printers() as $printer)
@{{ $printer->displayName }} @@endforeach
@@use(Native\Desktop\Facades\System)

@@foreach(System::printers() as $printer)
@{{ $printer->displayName }}
@@endforeach
```

Each item in the printers array is a `\Native\Desktop\DataObjects\Printer` which contains various device details and
Expand Down