From 3c8ad059309b09b0169e5e6baa362a2e1fa4aeeb Mon Sep 17 00:00:00 2001 From: erri120 Date: Thu, 27 Jun 2024 16:48:56 +0200 Subject: [PATCH 1/3] Update system requirements --- docs/users/SystemRequirements.md | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) diff --git a/docs/users/SystemRequirements.md b/docs/users/SystemRequirements.md index 465cdfad0f..ec4dc3c9f2 100644 --- a/docs/users/SystemRequirements.md +++ b/docs/users/SystemRequirements.md @@ -31,10 +31,12 @@ This page lists the recommended system requirements to install and run the app o \* Storage space required does not factor in the number of games managed, the size of the managed games and the mods installed. --> ### Linux Dependencies + The App requires the following programs to be available at runtime: -- `xdg-open` to open URLs in your browser. -- `update-desktop-database` to update the MIME cache after creating a desktop entry file for the NXM link handler. +- `xdg-open` (part of [xdg-utils](https://www.freedesktop.org/wiki/Software/xdg-utils/)) +- `xdg-settings` (part of [xdg-utils](https://www.freedesktop.org/wiki/Software/xdg-utils/)) +- `update-desktop-database` (part of [desktop-file-utils](https://www.freedesktop.org/wiki/Software/desktop-file-utils/)) In addition, the following libraries are required: From 44a9e2a31c6d14dba25aeb4f631e6cb9de2a9806 Mon Sep 17 00:00:00 2001 From: erri120 Date: Thu, 27 Jun 2024 16:56:43 +0200 Subject: [PATCH 2/3] Update docs for package maintainers --- docs/developers/Contributing.md | 14 +++++++++++--- 1 file changed, 11 insertions(+), 3 deletions(-) diff --git a/docs/developers/Contributing.md b/docs/developers/Contributing.md index f670677466..de9c236341 100644 --- a/docs/developers/Contributing.md +++ b/docs/developers/Contributing.md @@ -20,13 +20,21 @@ Translations are currently handled via the IDE. See [this issue](https://github. ## For Package Maintainers -If you want to create a package for your distribution, here are some helpful tips to get started: +If you want to create a package for your distribution, here are some helpful tips to get started. If you have questions or want to let us know about your new package, consider joining our [Discord](https://discord.gg/ReWTxb93jS). -- If possible, use `nexusmods-app` for the package name. +- If possible, use `nexusmods-app` for the package name and `com.nexusmods.app` as the rDNS ID. - We ship a build of `7zz` and use that executable unless you set `NEXUSMODS_APP_USE_SYSTEM_EXTRACTOR=1` when publishing. See [this issue](https://github.com/Nexus-Mods/NexusMods.App/issues/1306#issuecomment-2095755699) for details. - Set `INSTALLATION_METHOD_PACKAGE_MANAGER` when publishing. We have an integrated updater that will notify users about new versions. If you set this flag, we'll tell the user to update the App with their package manager. -- Let us know if you have questions or if you published a new package by joining our [Discord](https://discord.gg/ReWTxb93jS). We publish the App using [PupNet](https://github.com/kuiperzone/PupNet-Deploy). Releases are built using GitHub Actions, see [`build-linux-pupnet.yaml`](https://github.com/Nexus-Mods/NexusMods.App/blob/main/.github/workflows/build-linux-pupnet.yaml) for details. PupNet will use `dotnet publish` before packaging the result in some specialized format. If you don't wish to use PupNet, you should still use `dotnet publish` over `dotnet build`. The arguments we use with `dotnet publish` can be found in [`app.pupnet.conf`](https://github.com/Nexus-Mods/NexusMods.App/blob/main/src/NexusMods.App/app.pupnet.conf). Also see the [`dotnet publish` documentation](https://learn.microsoft.com/en-us/dotnet/core/tools/dotnet-publish#options) for a list of options. + +We provide a [Desktop Entry](https://specifications.freedesktop.org/desktop-entry-spec/desktop-entry-spec-latest.html) file called [`com.nexusmods.app.desktop`](../../src/NexusMods.App/com.nexusmods.app.desktop). When building the package, you should use this file and replace `${INSTALL_EXEC}` with an absolute path to the `NexusMods.App` binary. + +The App will [generate](../../src/NexusMods.CrossPlatform/ProtocolRegistration/ProtocolRegistrationLinux.cs) this `.desktop` file and replace the placeholder with the absolute path to the executable if `INSTALLATION_METHOD_PACKAGE_MANAGER` is not set. + +Besides the Desktop Entry file, we also provide the following files that you should make use of, if possible: + +- [AppStream](https://www.freedesktop.org/software/appstream/docs/) [`com.nexusmods.app.metainfo.xml`](../../src/NexusMods.App/com.nexusmods.app.metainfo.xml) +- [`icon.svg`](../../src/NexusMods.App/icon.svg) and [`icon.ico`](../../src/NexusMods.App/icon.ico) From 51be92e41b4e1ba0286ee71c504a6f6b4cbdc073 Mon Sep 17 00:00:00 2001 From: erri120 Date: Mon, 1 Jul 2024 09:49:00 +0200 Subject: [PATCH 3/3] Update docs --- docs/developers/Contributing.md | 11 +++++++---- docs/users/SystemRequirements.md | 2 +- 2 files changed, 8 insertions(+), 5 deletions(-) diff --git a/docs/developers/Contributing.md b/docs/developers/Contributing.md index de9c236341..114421728d 100644 --- a/docs/developers/Contributing.md +++ b/docs/developers/Contributing.md @@ -22,13 +22,16 @@ Translations are currently handled via the IDE. See [this issue](https://github. If you want to create a package for your distribution, here are some helpful tips to get started. If you have questions or want to let us know about your new package, consider joining our [Discord](https://discord.gg/ReWTxb93jS). -- If possible, use `nexusmods-app` for the package name and `com.nexusmods.app` as the rDNS ID. -- We ship a build of `7zz` and use that executable unless you set `NEXUSMODS_APP_USE_SYSTEM_EXTRACTOR=1` when publishing. See [this issue](https://github.com/Nexus-Mods/NexusMods.App/issues/1306#issuecomment-2095755699) for details. -- Set `INSTALLATION_METHOD_PACKAGE_MANAGER` when publishing. We have an integrated updater that will notify users about new versions. If you set this flag, we'll tell the user to update the App with their package manager. +If possible, use `nexusmods-app` for the package name and `com.nexusmods.app` as the rDNS ID for Flatpaks and similar. See [Linux Dependencies](../users/SystemRequirements.md#linux-dependencies) for a list of dependencies. + +There are various build variables you should consider using. You can set compile constants using `-p:DefineConstants="NAME"` with `dotnet build` or `dotnet publish`. For a full list of available application-specific compile constants, see [`Directory.Build.props`](../../Directory.Build.props): + +- `NEXUSMODS_APP_USE_SYSTEM_EXTRACTOR`: We ship a build of `7zz` that you can disable. Setting this constant will force the code to use `7zz` available in `PATH`. See [#1306](https://github.com/Nexus-Mods/NexusMods.App/issues/1306#issuecomment-2095755699) for details. Do note that some versions of `7zz` don't support RAR files, due to licensing issues. The build that the App ships with supports RAR files. Many mods still come in RAR archives, for a better user experience, we expect `7zz` to support RAR files. We won't accept issues around extraction failures for builds that don't support RAR archives. +- `INSTALLATION_METHOD_PACKAGE_MANAGER`: This constant will prevent the App from generating a `.desktop` file at runtime, and will change the update notification that notifies the user about new versions. If this constant is set, the App will tell the user to update using their package manager. We publish the App using [PupNet](https://github.com/kuiperzone/PupNet-Deploy). Releases are built using GitHub Actions, see [`build-linux-pupnet.yaml`](https://github.com/Nexus-Mods/NexusMods.App/blob/main/.github/workflows/build-linux-pupnet.yaml) for details. PupNet will use `dotnet publish` before packaging the result in some specialized format. -If you don't wish to use PupNet, you should still use `dotnet publish` over `dotnet build`. The arguments we use with `dotnet publish` can be found in [`app.pupnet.conf`](https://github.com/Nexus-Mods/NexusMods.App/blob/main/src/NexusMods.App/app.pupnet.conf). Also see the [`dotnet publish` documentation](https://learn.microsoft.com/en-us/dotnet/core/tools/dotnet-publish#options) for a list of options. +If you don't wish to use PupNet, you should still prefer `dotnet publish` over `dotnet build`. The arguments we use with `dotnet publish` can be found in [`app.pupnet.conf`](https://github.com/Nexus-Mods/NexusMods.App/blob/main/src/NexusMods.App/app.pupnet.conf). Also see the [`dotnet publish` documentation](https://learn.microsoft.com/en-us/dotnet/core/tools/dotnet-publish#options) for a list of options. We provide a [Desktop Entry](https://specifications.freedesktop.org/desktop-entry-spec/desktop-entry-spec-latest.html) file called [`com.nexusmods.app.desktop`](../../src/NexusMods.App/com.nexusmods.app.desktop). When building the package, you should use this file and replace `${INSTALL_EXEC}` with an absolute path to the `NexusMods.App` binary. diff --git a/docs/users/SystemRequirements.md b/docs/users/SystemRequirements.md index ec4dc3c9f2..cca79feb47 100644 --- a/docs/users/SystemRequirements.md +++ b/docs/users/SystemRequirements.md @@ -32,7 +32,7 @@ This page lists the recommended system requirements to install and run the app o ### Linux Dependencies -The App requires the following programs to be available at runtime: +The App requires the following programs to be available on the system `PATH` at runtime: - `xdg-open` (part of [xdg-utils](https://www.freedesktop.org/wiki/Software/xdg-utils/)) - `xdg-settings` (part of [xdg-utils](https://www.freedesktop.org/wiki/Software/xdg-utils/))