You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
@@ -58,15 +58,15 @@ After that, the `npm run release` process will automatically notarize the app fo
58
58
59
59
## EtcherSDK
60
60
61
-
Reflasher uses the etcher-sdk to flash and mount drives.
61
+
FlockFlasher uses the etcher-sdk to flash and mount drives.
62
62
63
63
The `etcher-sdk` requires root permissions to access drives and flash drives.
64
64
65
-
In the current build for MacOS and Linux, we must spawn a subprocess within the Reflasher that gets elevated.
65
+
In the current build for MacOS and Linux, we must spawn a subprocess within the FlockFlasher that gets elevated.
66
66
67
67
The easiest way to do that is to spawn a root process using sudo. This process will be a node process that runs the `etcher-sdk` code.
68
68
69
-
To do so, we create an external JavaScript script that uses the `etcher-sdk`. This script needs to point to the node_modules that are contained within the application (for production). To do so, we point to the compressed (ASAR) node_modules [in the code](https://github.com/RecordEvolution/Reflasher/blob/3400ca34a438af2653ee1dfc364cd3f066cdc7fd/src/main/api/flash.ts#L121).
69
+
To do so, we create an external JavaScript script that uses the `etcher-sdk`. This script needs to point to the node_modules that are contained within the application (for production). To do so, we point to the compressed (ASAR) node_modules [in the code](https://github.com/RecordEvolution/FlockFlasher/blob/3400ca34a438af2653ee1dfc364cd3f066cdc7fd/src/main/api/flash.ts#L121).
70
70
71
71
72
72
To learn more about the compressed ASAR package: https://www.electronjs.org/docs/latest/tutorial/asar-archives
@@ -76,22 +76,22 @@ Since we don't want to rely on the user having the `node` binary installed, we c
76
76
77
77
The electron binary can be accessed on `process.execPath` within the application and can be put into 'node mode' using the `ELECTRON_RUN_AS_NODE` environment variable.
78
78
79
-
Since we spawn a subprocess, we need to be able to read back the flashing progress of this subprocess. To do so, we print the progress data to the stdout in JSON string, which is then read and parsed in the frontend. ([Line in code](https://github.com/RecordEvolution/Reflasher/blob/3400ca34a438af2653ee1dfc364cd3f066cdc7fd/src/main/api/flash.ts#L154))
79
+
Since we spawn a subprocess, we need to be able to read back the flashing progress of this subprocess. To do so, we print the progress data to the stdout in JSON string, which is then read and parsed in the frontend. ([Line in code](https://github.com/RecordEvolution/FlockFlasher/blob/3400ca34a438af2653ee1dfc364cd3f066cdc7fd/src/main/api/flash.ts#L154))
80
80
81
81
82
82
### Windows
83
83
84
84
In order to access the USB drives in Windows, the `etcher-sdk` must include the `winusb-driver-generator` package. When running the `npm i` command on Windows, it will automatically and temporarily add this package using the `scripts/windows.js` script.
85
85
86
-
In order for Gulp to be able to build the Reflasher on Windows, it must compile the underlying winusb driver.
86
+
In order for Gulp to be able to build FlockFlasher on Windows, it must compile the underlying winusb driver.
87
87
88
88
Before you can do this, you must have the [Windows Driver Kit](https://learn.microsoft.com/en-us/windows-hardware/drivers/download-the-wdk) (WDK) installed.
89
89
90
90
There's a known issue where the `WDF redistributable co-installers don't work`, which is required in order to build the windows usb driver. Solutions can be found [here](https://learn.microsoft.com/en-us/windows-hardware/drivers/wdk-known-issues).
91
91
92
92
### AppImages (Linux)
93
93
94
-
For AppImages, it is sadly not straightforward to access the packaged node_modules within the application. Since the AppImage is technically a drive, we must first mount it to a temporary folder ([link to code](https://github.com/RecordEvolution/Reflasher/blob/3400ca34a438af2653ee1dfc364cd3f066cdc7fd/src/main/api/permissions.ts#L169)) and then access the packaged node modules within.
94
+
For AppImages, it is sadly not straightforward to access the packaged node_modules within the application. Since the AppImage is technically a drive, we must first mount it to a temporary folder ([link to code](https://github.com/RecordEvolution/FlockFlasher/blob/3400ca34a438af2653ee1dfc364cd3f066cdc7fd/src/main/api/permissions.ts#L169)) and then access the packaged node modules within.
0 commit comments