2022-09-06 19:25:43 -04:00
|
|
|
Packages for various operating systems
|
|
|
|
|
======================================
|
|
|
|
|
|
2022-09-06 22:37:27 -04:00
|
|
|
Making a new release:
|
|
|
|
|
---------------------
|
|
|
|
|
|
|
|
|
|
Releases can be created in a mostly automatic way. With a working Java toolchain
|
|
|
|
|
including jpackage installed:
|
|
|
|
|
|
|
|
|
|
0. Set a `GITHUB_TOKEN` in the environment containing an API key.
|
2022-09-07 13:58:02 -04:00
|
|
|
1. Update `CHANGES.md`
|
|
|
|
|
2. Update the version number(`GITHUB_TAG`) and version title(`GITHUB_NAME`) in `config.sh`
|
|
|
|
|
3. On a Linux machine, run `./release.sh`
|
|
|
|
|
4. On a Windows machine, run `./windows-release.sh`
|
2022-09-15 14:12:24 -04:00
|
|
|
5. On whatever machine you check in code with, run `./packages.sh`
|
2022-09-06 22:37:27 -04:00
|
|
|
|
2022-09-06 19:25:43 -04:00
|
|
|
Windows
|
|
|
|
|
-------
|
|
|
|
|
|
|
|
|
|
All Windows packages require building on a Windows machine. In order to build
|
|
|
|
|
them, check out i2p.firefox in an adjacent directory and `source` i2p.firefox/config.sh
|
|
|
|
|
to set the path to the Java toolchain you want to use.
|
|
|
|
|
|
|
|
|
|
run: `ant jar` before any of these scripts.
|
|
|
|
|
|
|
|
|
|
run: `windows-release.sh` only *after* release.sh on a Linux machine.
|
|
|
|
|
|
|
|
|
|
### MSI
|
|
|
|
|
|
|
|
|
|
Requires the Wixl toolset.
|
|
|
|
|
|
2022-09-06 22:37:27 -04:00
|
|
|
#### Status: Works. Maintained.
|
|
|
|
|
|
2022-09-06 19:25:43 -04:00
|
|
|
run: `./windows.sh`
|
|
|
|
|
|
2022-09-06 19:27:02 -04:00
|
|
|
#### EXE
|
|
|
|
|
|
2022-09-06 19:25:43 -04:00
|
|
|
No special requirements.
|
|
|
|
|
|
2022-09-06 22:37:27 -04:00
|
|
|
#### Status: Works. Maintained.
|
|
|
|
|
|
2022-09-06 19:25:43 -04:00
|
|
|
run: `./windows-exe.sh`
|
|
|
|
|
|
2022-09-06 19:27:02 -04:00
|
|
|
### Portable(.zip)
|
|
|
|
|
|
2022-09-06 19:25:43 -04:00
|
|
|
No special requirements.
|
|
|
|
|
|
2022-09-06 22:37:27 -04:00
|
|
|
#### Status: Unknown. Maintained.
|
|
|
|
|
|
2022-09-06 19:25:43 -04:00
|
|
|
run: `./windows-portable.sh`
|
|
|
|
|
|
|
|
|
|
Linux
|
|
|
|
|
-----
|
|
|
|
|
|
|
|
|
|
All Linux packages require building on a Linux machines. Debian packages must
|
|
|
|
|
be built on Debian, Fedora packages must be built on Fedora. Some leeway for
|
|
|
|
|
derivative distros. Portable can be b build anywhere with a jpackage. Have
|
|
|
|
|
Java tools in your `PATH`.
|
|
|
|
|
|
2022-09-06 19:27:02 -04:00
|
|
|
### Debian
|
|
|
|
|
|
2022-09-06 19:25:43 -04:00
|
|
|
Make sure you have a recent Java and jpackage.
|
|
|
|
|
|
2022-09-06 22:37:27 -04:00
|
|
|
#### Status: Works. Maintained.
|
|
|
|
|
|
2022-09-06 19:25:43 -04:00
|
|
|
run: `ant debian`
|
|
|
|
|
|
2022-09-06 19:27:02 -04:00
|
|
|
### Fedora
|
|
|
|
|
|
2022-09-06 19:25:43 -04:00
|
|
|
I'm a Debian user and don't have a Fedora machine set up right now. Therefore,
|
|
|
|
|
I build Fedora packages in a container.
|
|
|
|
|
|
|
|
|
|
Fedora doesn't have a jpackage in their repositories as far as I can tell so I use
|
|
|
|
|
Adoptium's third-party repository to supply the JDK I use to build the fedora
|
|
|
|
|
package.
|
|
|
|
|
|
2022-09-06 22:37:27 -04:00
|
|
|
#### Status: Unknown. Maintained.
|
|
|
|
|
|
2022-09-06 19:25:43 -04:00
|
|
|
run: `ant fedora`
|
|
|
|
|
|
2022-09-06 19:27:02 -04:00
|
|
|
### Portable(.zip)
|
|
|
|
|
|
2022-09-06 19:25:43 -04:00
|
|
|
Details are platform dependent. Same build-deps as everything else.
|
|
|
|
|
|
2022-09-06 22:37:27 -04:00
|
|
|
#### Status: Works. Maintained.
|
|
|
|
|
|
2022-09-06 19:25:43 -04:00
|
|
|
run: `ant jpackage`
|
|
|
|
|
|
|
|
|
|
OSX
|
|
|
|
|
---
|
|
|
|
|
|
|
|
|
|
### TODO
|
