1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
|
# Build Gajim on macOS
To build omemo-dr, nbxmpp and Gajim on macOS, you can follow [the wiki page](https://dev.gajim.org/gajim/gajim/-/wikis/help/Gajim-on-macOS).
But in this directory we also provide a Bash script (`gajim-macos-helper.sh`) to help creating virtual environments for omemo-dr, nbxmpp and Gajim in Mac OS, build it, start it from the virtual environment, and also create a `.dmg` bundle.
## Requirements for this script
You just need [Brew](https://brew.sh) (follow instructions on the website) and Bash (installed by default on macOS), the script will install and do the rest.
## Usage
The `gajim-macos-helper.sh` script need to be copied alone in an empty directory of your choice, without anything else.
Always run the `gajim-macos-helper.sh` script from within the directory where you placed it (`./gajim-macos-helper.sh <argument>` style).
### Build specific version of omemo-dr, nbxmpp and Gajim
Always check the versions variables inside the `gajim-macos-helper.sh` script: check tags dates on Gitlab to make [omemo-dr](https://dev.gajim.org/gajim/omemo-dr/-/tags), [nbxmpp](https://dev.gajim.org/gajim/python-nbxmpp/-/tags) and [Gajim](https://dev.gajim.org/gajim/gajim/-/tags) versions match (example: Gajim version `2.4.1` match omemo-dr version `1.1.0` and nbxmpp version `7.0.0`)
To build (or rebuild) a new version of omemo-dr, nbxmpp and Gajim, run:
```
./gajim-macos-helper.sh build
```
> Note: If a previous build was done this way, it will be destroyed first. This command install dependencies via Brew, create a Python virtual environment and build omemo-dr, nbxmpp and Gajim.
#### Build in CI mode
The "CI mode" install all dependencies system side (without any virtual environment) and is used with the goal of building a `.dmg` file after this. It is used mostly in CI or containers, don't use it for dev purpose.
```
./gajim-macos-helper.sh build ci
```
You can also build a specific version of Gajim, `omemo-dr` and `nbxmpp` will installed via `pip` instead of git source:
```
./gajim-macos-helper.sh build ci 2.4.1
```
### Start the Gajim version you just built
To start built version, run:
```
./gajim-macos-helper.sh start
```
> Note: This command enter inside the Python virtual environment and launch Gajim.
### Create a DMG file (CI mode)
The "CI mode" install all dependencies system side (without any virtual environment) and need to be run after the `build ci` command. It is used mostly in CI or containers, don't use it for dev purpose.
To create a `.dmg` file, run:
```
./gajim-macos-helper.sh create-dmg ci
```
> Note: This command use PyInstaller to create a `gajim-<version>.dmg` file.
You can also build a specific version of Gajim (mostly used for Gajim's CI):
```
./gajim-macos-helper.sh create-dmg ci 2.4.1
```
|
