Merge pull request #712 from silentrald/wiki/deb

[wiki] added deb install thru ppa repo in github

docs/wiki/Linux.md

@@ -6,11 +6,34 @@ Go to [Releases](https://github.com/Zagrios/bs-manager/releases) page and go to
 
 ### Ubuntu, Debian (deb)
 
+#### PPA Repository
+
+Refer to [bs-manager-deb](https://github.com/silentrald/bs-manager-deb).
+
+Add the BSManager PPA repository into your system with the following commands.
+
+```bash
+curl -fsSL https://raw.githubusercontent.com/silentrald/bs-manager-deb/refs/heads/main/KEY.gpg | sudo gpg --dearmor -o /usr/share/keyrings/bs-manager.gpg
+echo "deb [signed-by=/usr/share/keyrings/bs-manager.gpg] https://raw.githubusercontent.com/silentrald/bs-manager-deb/refs/heads/main ./" | sudo tee /etc/apt/sources.list.d/bs-manager.list
+sudo apt update
+```
+
+Install the `bs-manager` package using `apt`.
+```bash
+sudo apt install bs-manager
+```
+
+#### dpkg install
+
 Download the `.deb` file in the releases and run the following command:
 ```bash
 dpkg -i ./bsmanager.deb
 ```
 
+**NOTE:** When installed using dpkg, BSManager will not automatically update to the latest version. You have to either:
+* Download the latest `.deb` file on the Releases page; or
+* Install thru PPA repository to automatically update with `sudo apt update & sudo apt upgrade`.
+
 ### Arch (AUR)
 
 Refer to [bs-manager-git](https://aur.archlinux.org/packages/bs-manager-git).

electron-builder.config.js

@@ -51,6 +51,10 @@ const config = {
         fpm: ["--after-install=build/after-install.sh"],
     },
     flatpak: {
+        // Version of org.electronjs.Electron2.BaseApp
+        baseVersion: "24.08",
+        // Version of org.freedesktop.Platform
+        runtimeVersion: "24.08",
         finishArgs: [
             // Wayland/X11 Rendering
             "--socket=wayland",

package.json

@@ -21,7 +21,8 @@
         "test": "jest",
         "test:unit": "jest ./src/__tests__/unit",
         "publish": "npm run build && electron-builder -c.win.certificateSha1=206941d969c4fa8a0e04d9427def361e13b02fd0 --config electron-builder.config.js --publish always --win --x64",
-        "publish:linux": "npm run build && electron-builder --config electron-builder.config.js --publish never --linux --x64"
+        "publish:linux": "npm run build && electron-builder --config electron-builder.config.js --publish never --linux --x64",
+        "publish:flatpak": "npm run build && env DEBUG='@malept/flatpak-bundler' npx electron-builder --config electron-builder.config.js --publish never --linux flatpak"
     },
     "lint-staged": {
         "*.{js,jsx,ts,tsx}": [

src/renderer/pages/version-viewer.component.tsx

@@ -1,6 +1,6 @@
 import { BSVersion } from "shared/bs-version.interface";
 import { useState } from "react";
-import { useLocation, useNavigate } from "react-router-dom";
+import { Navigate, useLocation, useNavigate } from "react-router-dom";
 import { TabNavBar } from "renderer/components/shared/tab-nav-bar.component";
 import { BsmDropdownButton } from "renderer/components/shared/bsm-dropdown-button.component";
 import { BsmImage } from "renderer/components/shared/bsm-image.component";
@@ -24,6 +24,7 @@ import { BsDownloaderService } from "renderer/services/bs-version-download/bs-do
 import { useOnUpdate } from "renderer/hooks/use-on-update.hook";
 import { safeLt } from "shared/helpers/semver.helpers";
 import { ConfigurationService } from "renderer/services/configuration.service";
+import { logRenderError } from "renderer";
 
 export function VersionViewer() {
 
@@ -36,7 +37,7 @@ export function VersionViewer() {
     const notification = useService(NotificationService);
     const config = useService(ConfigurationService);
 
-    const { state } = useLocation() as { state: BSVersion };
+    const { state, pathname: url } = useLocation() as { state: BSVersion; pathname: string };
     const navigate = useNavigate();
     const [currentTabIndex, setCurrentTabIndex] = useState(0);
 
@@ -132,6 +133,13 @@ export function VersionViewer() {
         });
     }
 
+    // If state/version is not properly set, or becomes null for some reason
+    //   redirect user to the available-versions page
+    if (!state) {
+        logRenderError(`Missing state/version for "${url}"`);
+        return <Navigate to="/available-versions" replace />;
+    }
+
     return (
         <>
             <BsmImage className="absolute w-full h-full top-0 left-0 object-cover" image={state.ReleaseImg || DefautVersionImage} errorImage={DefautVersionImage} />