mirror of
https://github.com/ProtonMail/proton-bridge.git
synced 2025-12-10 12:46:46 +00:00
GODT-1941: Update documentation
This commit is contained in:
40
BUILDS.md
40
BUILDS.md
@ -1,13 +1,12 @@
|
|||||||
# Building Proton Mail Bridge and Import-Export app
|
# Building Proton Mail Bridge
|
||||||
|
|
||||||
## Prerequisites
|
## Prerequisites
|
||||||
* 64-bit AMD OS:
|
* 64-bit OS:
|
||||||
- the go-rfc5322 module cannot currently be compiled for 32-bit OSes
|
- the go-rfc5322 module cannot currently be compiled for 32-bit OSes
|
||||||
- the Apple M1 builds are not supported yet due to dependencies
|
* Go 1.18
|
||||||
* Go 1.13
|
|
||||||
* Bash with basic build utils: make, gcc, sed, find, grep, ...
|
* Bash with basic build utils: make, gcc, sed, find, grep, ...
|
||||||
* For Windows it is recommended to use MinGW 64bit shell from [MSYS2](https://www.msys2.org/)
|
- For Windows it is recommended to use MinGW 64bit shell from [MSYS2](https://www.msys2.org/)
|
||||||
* GCC (linux, windows) or Xcode (macOS)
|
* GCC (linux), msvc (windows) or Xcode (macOS)
|
||||||
* Windres (windows)
|
* Windres (windows)
|
||||||
* libglvnd and libsecret development files (linux)
|
* libglvnd and libsecret development files (linux)
|
||||||
|
|
||||||
@ -16,16 +15,11 @@ To enable the sending of crash reports using Sentry please set the
|
|||||||
Otherwise, the sending of crash reports will be disabled.
|
Otherwise, the sending of crash reports will be disabled.
|
||||||
|
|
||||||
## Build
|
## Build
|
||||||
In order to build Bridge or Import-Export app with Qt interface we are using
|
In order to build Bridge app with Qt interface we are using
|
||||||
[Qt Go Binding](https://github.com/therecipe/qt). The dependencies and
|
[Qt 6.3](https://doc.qt.io/qt-6/gettingstarted.html).
|
||||||
installation of this tool is part of `make build` target. If you have issues
|
|
||||||
with installation of therecipe/qt we recommend to follow [this
|
|
||||||
wiki](https://github.com/therecipe/qt/wiki/Installation-on-Linux)
|
|
||||||
|
|
||||||
Please note that `$(go env GOPATH)/bin` must be in your `PATH` to ensure
|
|
||||||
binaries installed by `therecipe/qt` (such as `qtdeploy`) are found. Also,
|
|
||||||
before you start build **on Windows**, please unset the `MSYSTEM` variable
|
|
||||||
|
|
||||||
|
Please note that qmake path must be in your `PATH` to ensure Qt to be found.
|
||||||
|
Also, before you start build **on Windows**, please unset the `MSYSTEM` variable
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
export MSYSTEM=
|
export MSYSTEM=
|
||||||
@ -54,24 +48,12 @@ make build-nogui
|
|||||||
* Bridge always has the option (whether built with Qt or without) to use a CLI interface by starting it with the argument `-c`
|
* Bridge always has the option (whether built with Qt or without) to use a CLI interface by starting it with the argument `-c`
|
||||||
* NOTE: You still need to setup supported keychain on your system
|
* NOTE: You still need to setup supported keychain on your system
|
||||||
|
|
||||||
### Build Import-Export
|
## Launchers
|
||||||
* in project root run
|
|
||||||
|
|
||||||
```bash
|
|
||||||
make build-ie
|
|
||||||
```
|
|
||||||
|
|
||||||
* The result will be stored in `./cmd/Import-Export/deploy/${GOOS}/`
|
|
||||||
* for `linux`, the binary will have the name of the project directory (e.g `proton-bridge`)
|
|
||||||
* for `windows`, the binary will have the file extension `.exe` (e.g `proton-bridge.exe`)
|
|
||||||
* for `darwin`, the application will be created with name of the project directory (e.g `proton-bridge.app`)
|
|
||||||
|
|
||||||
### Launchers
|
|
||||||
Launchers are only included in official distributions and provide the public
|
Launchers are only included in official distributions and provide the public
|
||||||
key used to verify signed app binaries, allowing the automatic update feature.
|
key used to verify signed app binaries, allowing the automatic update feature.
|
||||||
See README for more information.
|
See README for more information.
|
||||||
|
|
||||||
### Tags
|
## Tags
|
||||||
Note that repository contains both Bridge and Import-Export apps and they are
|
Note that repository contains both Bridge and Import-Export apps and they are
|
||||||
not released together. Therefore, each app has own tag prefix. Bridge tags
|
not released together. Therefore, each app has own tag prefix. Bridge tags
|
||||||
starts with `br-` and Import-Export tags starts with `ie-`. Both tags continue
|
starts with `br-` and Import-Export tags starts with `ie-`. Both tags continue
|
||||||
|
|||||||
15
README.md
15
README.md
@ -24,21 +24,6 @@ background.
|
|||||||
|
|
||||||
More details [on the public website](https://protonmail.com/bridge).
|
More details [on the public website](https://protonmail.com/bridge).
|
||||||
|
|
||||||
## Description Import-Export app
|
|
||||||
Proton Mail Import-Export app for importing and exporting messages.
|
|
||||||
|
|
||||||
To transfer messages, firstly log in using your Proton Mail credentials.
|
|
||||||
For import, expand your account, and pick the address to which to import
|
|
||||||
messages from IMAP server or local EML or MBOX files. For export, pick
|
|
||||||
the whole account or only a specific address. Then, in both cases,
|
|
||||||
configure transfer rules (match source and target mailboxes, set time
|
|
||||||
range limits and so on) and hit start. Once the transfer is complete,
|
|
||||||
check the results.
|
|
||||||
|
|
||||||
More details [on the public website](https://protonmail.com/import-export).
|
|
||||||
|
|
||||||
The Import-Export app is developed in separate branch `master-ie`.
|
|
||||||
|
|
||||||
## Launchers
|
## Launchers
|
||||||
Launchers are binaries used to run the Proton Mail Bridge or Import-Export apps.
|
Launchers are binaries used to run the Proton Mail Bridge or Import-Export apps.
|
||||||
|
|
||||||
|
|||||||
Reference in New Issue
Block a user