From 60458a51e0805addaa39e86653de322b74528ba6 Mon Sep 17 00:00:00 2001 From: GithubAnon0000 <160563432+GithubAnon0000@users.noreply.github.com> Date: Fri, 3 Oct 2025 22:21:58 +0000 Subject: [PATCH 01/12] ADD Dependencies for linux when building the launcher I only downloaded `gcc-aarch64-linux-gnu` (on my x86_64 debian sid) and it was able to successfully build the launcher. --- docs/linux.md | 7 +++++++ 1 file changed, 7 insertions(+) diff --git a/docs/linux.md b/docs/linux.md index 55794e074..2597bc717 100644 --- a/docs/linux.md +++ b/docs/linux.md @@ -41,6 +41,13 @@ On some distros such as Arch Linux and Fedora, you may need to install the error while loading shared libraries: libcrypt.so.1: cannot open shared object file: No such file or directory ``` +## Dependencies for building the launcher + +If you want to build the launcher, you will need to install the following dependency: +``` +sudo apt install gcc-aarch64-linux-gnu +``` + ## Audio To play and record audio during development, install mpv and lame. From 1b39efd6cbe13b92cf3298d24351fbd057b9492e Mon Sep 17 00:00:00 2001 From: GithubAnon0000 <160563432+GithubAnon0000@users.noreply.github.com> Date: Fri, 3 Oct 2025 22:31:38 +0000 Subject: [PATCH 02/12] ADD example build / run instructions for the launcher for linux --- docs/development.md | 14 ++++++++++++++ 1 file changed, 14 insertions(+) diff --git a/docs/development.md b/docs/development.md index defe9ef1e..51c90688d 100644 --- a/docs/development.md +++ b/docs/development.md @@ -195,6 +195,20 @@ If ANKI_PROFILE_CODE is set, Python profiling data will be written on exit. - The anki-release package is created/published with the scripts in qt/release. - The installer/launcher is created with the build scripts in qt/launcher/{platform}. +On Linux, you can build the launcher by following these steps: +``` +cd ./qt/launcher/lin/ +./build.sh +``` + +After that, you will get a path to the launcher folder and can run it via +``` +../../../out/launcher/anki-launcher-25.09.2-linux/launcher.amd64 +``` + +If you are experiencing issues building the launcher, make sure that all dependencies +are installed. See [Building from source](#building-from-source) for more info. + ## Mixing development and study You may wish to create a separate profile with File>Switch Profile for use From 0215a5ff511e032c25d3d82206d66f42ef98db0d Mon Sep 17 00:00:00 2001 From: GithubAnon0000 <160563432+GithubAnon0000@users.noreply.github.com> Date: Sat, 4 Oct 2025 00:51:51 +0200 Subject: [PATCH 03/12] CHORE: ninja format && fix --- docs/development.md | 2 ++ docs/linux.md | 1 + 2 files changed, 3 insertions(+) diff --git a/docs/development.md b/docs/development.md index 51c90688d..a145260c5 100644 --- a/docs/development.md +++ b/docs/development.md @@ -196,12 +196,14 @@ If ANKI_PROFILE_CODE is set, Python profiling data will be written on exit. - The installer/launcher is created with the build scripts in qt/launcher/{platform}. On Linux, you can build the launcher by following these steps: + ``` cd ./qt/launcher/lin/ ./build.sh ``` After that, you will get a path to the launcher folder and can run it via + ``` ../../../out/launcher/anki-launcher-25.09.2-linux/launcher.amd64 ``` diff --git a/docs/linux.md b/docs/linux.md index 2597bc717..4c38e7d27 100644 --- a/docs/linux.md +++ b/docs/linux.md @@ -44,6 +44,7 @@ error while loading shared libraries: libcrypt.so.1: cannot open shared object f ## Dependencies for building the launcher If you want to build the launcher, you will need to install the following dependency: + ``` sudo apt install gcc-aarch64-linux-gnu ``` From 82754f7fc350babb15b6179487bd3bf63117ed5b Mon Sep 17 00:00:00 2001 From: GithubAnon0000 <160563432+GithubAnon0000@users.noreply.github.com> Date: Mon, 13 Oct 2025 14:13:36 +0200 Subject: [PATCH 04/12] ADD: Entries for Mac and Windows --- docs/development.md | 33 ++++++++++++++++++++++++++++----- 1 file changed, 28 insertions(+), 5 deletions(-) diff --git a/docs/development.md b/docs/development.md index a145260c5..d82ca172a 100644 --- a/docs/development.md +++ b/docs/development.md @@ -195,22 +195,45 @@ If ANKI_PROFILE_CODE is set, Python profiling data will be written on exit. - The anki-release package is created/published with the scripts in qt/release. - The installer/launcher is created with the build scripts in qt/launcher/{platform}. -On Linux, you can build the launcher by following these steps: +## Building + +The steps to build the launcher vary slightly depending on your operating +system. First, you have to navigate to the appropriate folder: +| Operating System | Path | +|---|---| +| Linux | ./qt/launcher/lin/ | +| MacOS | ./qt/launcher/mac/ | +| Windows | .\qt\launcher\win\ | + +Next, run the `build.sh` script (on Linux and MacOS) or the `build.bat` script +(on Windows). + +For example, on Linux, you can build the launcher by following these steps: ``` cd ./qt/launcher/lin/ ./build.sh ``` -After that, you will get a path to the launcher folder and can run it via +## Issues during Building + +If you are experiencing issues building the launcher, make sure that all dependencies +are installed. See [Building from source](#building-from-source) for more info. + +## Running + +After building, the launcher executable can found under `out/launcher` (located +in the project root). In that folder, you will find a `launcher.amd64` and a +`launcher.arm64` binary file. Select the one matching your architecture and run +it to test your changes. + +For example, on Linux, after following the build steps above, you can run the +amd64 launcher via this command: ``` ../../../out/launcher/anki-launcher-25.09.2-linux/launcher.amd64 ``` -If you are experiencing issues building the launcher, make sure that all dependencies -are installed. See [Building from source](#building-from-source) for more info. - ## Mixing development and study You may wish to create a separate profile with File>Switch Profile for use From f20007938ae890ba60fe43109f89683d6d55754c Mon Sep 17 00:00:00 2001 From: GithubAnon0000 <160563432+GithubAnon0000@users.noreply.github.com> Date: Mon, 13 Oct 2025 14:14:22 +0200 Subject: [PATCH 05/12] FIX: Wrong level was applied to a header --- docs/development.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/development.md b/docs/development.md index d82ca172a..e9c9b727e 100644 --- a/docs/development.md +++ b/docs/development.md @@ -234,7 +234,7 @@ amd64 launcher via this command: ../../../out/launcher/anki-launcher-25.09.2-linux/launcher.amd64 ``` -## Mixing development and study +# Mixing development and study You may wish to create a separate profile with File>Switch Profile for use during development. You can pass the arguments "-p [profile name]" when starting From 71a2c46a097ff572c98fc6044a737b6f439b6b40 Mon Sep 17 00:00:00 2001 From: GithubAnon0000 <160563432+GithubAnon0000@users.noreply.github.com> Date: Mon, 13 Oct 2025 14:17:57 +0200 Subject: [PATCH 06/12] CHORE: ninja fix && format --- docs/development.md | 11 ++++++----- 1 file changed, 6 insertions(+), 5 deletions(-) diff --git a/docs/development.md b/docs/development.md index e9c9b727e..738376474 100644 --- a/docs/development.md +++ b/docs/development.md @@ -199,11 +199,12 @@ If ANKI_PROFILE_CODE is set, Python profiling data will be written on exit. The steps to build the launcher vary slightly depending on your operating system. First, you have to navigate to the appropriate folder: -| Operating System | Path | -|---|---| -| Linux | ./qt/launcher/lin/ | -| MacOS | ./qt/launcher/mac/ | -| Windows | .\qt\launcher\win\ | + +| Operating System | Path | +| ---------------- | ------------------ | +| Linux | ./qt/launcher/lin/ | +| MacOS | ./qt/launcher/mac/ | +| Windows | .\qt\launcher\win\ | Next, run the `build.sh` script (on Linux and MacOS) or the `build.bat` script (on Windows). From 63184ad18db18cf9b67381d959e4ef09c46dd33c Mon Sep 17 00:00:00 2001 From: GithubAnon0000 <160563432+GithubAnon0000@users.noreply.github.com> Date: Mon, 13 Oct 2025 14:51:56 +0000 Subject: [PATCH 07/12] FIX: Sentence structure --- docs/development.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/development.md b/docs/development.md index 738376474..588a695e9 100644 --- a/docs/development.md +++ b/docs/development.md @@ -223,7 +223,7 @@ are installed. See [Building from source](#building-from-source) for more info. ## Running -After building, the launcher executable can found under `out/launcher` (located +Once the launcher is built, you can find the executable under `out/launcher` (located in the project root). In that folder, you will find a `launcher.amd64` and a `launcher.arm64` binary file. Select the one matching your architecture and run it to test your changes. From ba989354a75ba0658d5a9b9f10bf689c0abf969c Mon Sep 17 00:00:00 2001 From: GithubAnon0000 <160563432+GithubAnon0000@users.noreply.github.com> Date: Mon, 27 Oct 2025 18:13:20 +0000 Subject: [PATCH 08/12] FIX: casing (thanks dae) Co-authored-by: Damien Elmes --- docs/development.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/development.md b/docs/development.md index 588a695e9..25a4e0acf 100644 --- a/docs/development.md +++ b/docs/development.md @@ -216,7 +216,7 @@ cd ./qt/launcher/lin/ ./build.sh ``` -## Issues during Building +## Issues During Building If you are experiencing issues building the launcher, make sure that all dependencies are installed. See [Building from source](#building-from-source) for more info. From b041118af28c0d4ee4f10e66520e73d32165e40c Mon Sep 17 00:00:00 2001 From: GithubAnon0000 <160563432+GithubAnon0000@users.noreply.github.com> Date: Mon, 27 Oct 2025 18:16:27 +0000 Subject: [PATCH 09/12] FIX: casing --- docs/linux.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/linux.md b/docs/linux.md index 4c38e7d27..a4d3bdc28 100644 --- a/docs/linux.md +++ b/docs/linux.md @@ -41,7 +41,7 @@ On some distros such as Arch Linux and Fedora, you may need to install the error while loading shared libraries: libcrypt.so.1: cannot open shared object file: No such file or directory ``` -## Dependencies for building the launcher +## Dependencies for Building the Launcher If you want to build the launcher, you will need to install the following dependency: From 2cba97d92a14cc16f2167db5f53e7eb723d773b1 Mon Sep 17 00:00:00 2001 From: GithubAnon0000 <160563432+GithubAnon0000@users.noreply.github.com> Date: Sun, 2 Nov 2025 17:36:35 +0100 Subject: [PATCH 10/12] FIX: binary statement (only linux has amd64 and arm64 versions) --- docs/development.md | 10 ++++++---- 1 file changed, 6 insertions(+), 4 deletions(-) diff --git a/docs/development.md b/docs/development.md index 25a4e0acf..23a1e7513 100644 --- a/docs/development.md +++ b/docs/development.md @@ -223,10 +223,12 @@ are installed. See [Building from source](#building-from-source) for more info. ## Running -Once the launcher is built, you can find the executable under `out/launcher` (located -in the project root). In that folder, you will find a `launcher.amd64` and a -`launcher.arm64` binary file. Select the one matching your architecture and run -it to test your changes. +Once the launcher is built, you can find the executable under `out/launcher` +(located in the project root). In that folder, you will find the binary file of +the launcher. + +On linux, you will find a `launcher.amd64` and a `launcher.arm64` binary file. +Select the one matching your architecture and run it to test your changes. For example, on Linux, after following the build steps above, you can run the amd64 launcher via this command: From d040148b866896fa12985df0752cd8d1fe5ea86e Mon Sep 17 00:00:00 2001 From: GithubAnon0000 <160563432+GithubAnon0000@users.noreply.github.com> Date: Sun, 2 Nov 2025 17:42:13 +0100 Subject: [PATCH 11/12] UPDATE: Include env vars for Win and Mac --- docs/development.md | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/docs/development.md b/docs/development.md index 23a1e7513..01fbd4642 100644 --- a/docs/development.md +++ b/docs/development.md @@ -206,6 +206,11 @@ system. First, you have to navigate to the appropriate folder: | MacOS | ./qt/launcher/mac/ | | Windows | .\qt\launcher\win\ | +If you are on Windows, you will now have to set `NOCOMP=1` to skip code signing +and compression. If you are on MacOS, you will have to use `NODMG=1` to skip the +slow bundling / code signing. If you are on linux, you won't have to set any +special environment variables. + Next, run the `build.sh` script (on Linux and MacOS) or the `build.bat` script (on Windows). From efb1b1a4bcc452438d6d084144356d245f0a3ca3 Mon Sep 17 00:00:00 2001 From: GithubAnon0000 <160563432+GithubAnon0000@users.noreply.github.com> Date: Sun, 2 Nov 2025 17:55:39 +0100 Subject: [PATCH 12/12] CHANGE: include env vars for Win and Mac in the table instead --- docs/development.md | 17 ++++++++--------- 1 file changed, 8 insertions(+), 9 deletions(-) diff --git a/docs/development.md b/docs/development.md index 01fbd4642..8f8405219 100644 --- a/docs/development.md +++ b/docs/development.md @@ -200,16 +200,15 @@ If ANKI_PROFILE_CODE is set, Python profiling data will be written on exit. The steps to build the launcher vary slightly depending on your operating system. First, you have to navigate to the appropriate folder: -| Operating System | Path | -| ---------------- | ------------------ | -| Linux | ./qt/launcher/lin/ | -| MacOS | ./qt/launcher/mac/ | -| Windows | .\qt\launcher\win\ | +| Operating System | Path | Env variables | +| ---------------- | ------------------ | ------------- | +| Linux | ./qt/launcher/lin/ | - | +| MacOS | ./qt/launcher/mac/ | `NODMG=1` | +| Windows | .\qt\launcher\win\ | `NOCOMP=1` | -If you are on Windows, you will now have to set `NOCOMP=1` to skip code signing -and compression. If you are on MacOS, you will have to use `NODMG=1` to skip the -slow bundling / code signing. If you are on linux, you won't have to set any -special environment variables. +If you are on Windows or MacOS, you will now have to set the environment +variables as outlined in the table above. `NOCOMP=1` skips code signing +and compression, whereas `NODMG=1` skips the slow bundling / code signing. Next, run the `build.sh` script (on Linux and MacOS) or the `build.bat` script (on Windows).