2020-10-18 22:24:10 +00:00
|
|
|
Borepin
|
|
|
|
|
===
|
|
|
|
|
|
|
|
|
|
# Building
|
|
|
|
|
|
|
|
|
|
## On Windows
|
|
|
|
|
1. Install Visual Studio 2019
|
|
|
|
|
[download Visual Studio](https://visualstudio.microsoft.com/de/)
|
|
|
|
|
* with Xamarin
|
|
|
|
|
* with UWP
|
|
|
|
|
* with .NET Desktop
|
|
|
|
|
2. Install GTKSharp for Windows
|
|
|
|
|
[download GTKSharp](https://www.mono-project.com/download/stable/#download-win)
|
2020-11-12 12:19:37 +00:00
|
|
|
3. Install capnproto
|
|
|
|
|
|
|
|
|
|
3.1 If you have Chocolatey installed
|
|
|
|
|
```shell
|
|
|
|
|
$ choco install capnproto
|
|
|
|
|
```
|
|
|
|
|
3.2 else you can download it from [here](https://capnproto.org/install.html) and add it to your PATH
|
|
|
|
|
|
2020-10-18 22:24:10 +00:00
|
|
|
4. Clone Borepin
|
|
|
|
|
[download Borepin](https://gitlab.com/fabinfra/fabaccess/client)
|
|
|
|
|
6. Load Borepin
|
|
|
|
|
7. Build Borepin
|
|
|
|
|
|
|
|
|
|
If Step 5. Build Borepin is failing because of GTKSharp, it could help to restart your PC.
|
|
|
|
|
|
|
|
|
|
## Build GTK Project
|
2021-02-05 17:15:40 +00:00
|
|
|
1. Install mono
|
|
|
|
|
[download mono](https://www.mono-project.com/download/stable/#download-lin)
|
|
|
|
|
2. Install mono, gtk-sharp, msbuild, nuget
|
2020-10-18 22:24:10 +00:00
|
|
|
1.1 Debian based
|
|
|
|
|
```shell
|
2021-02-05 17:15:40 +00:00
|
|
|
$ apt install mono-complete, gtk-sharp2, libcanberra-gtk-module, nuget, capnproto, git
|
2020-10-18 22:24:10 +00:00
|
|
|
```
|
|
|
|
|
1.2 ArchLinux based
|
|
|
|
|
```shell
|
2020-11-12 12:19:37 +00:00
|
|
|
$ pacman -S mono, mono-msbuild, gtk-sharp-2, nuget, capnproto
|
2020-10-18 22:24:10 +00:00
|
|
|
```
|
2021-02-05 17:15:40 +00:00
|
|
|
3. Update NuGet
|
2020-10-18 22:24:10 +00:00
|
|
|
```shell
|
2021-02-05 17:15:40 +00:00
|
|
|
$ nuget update -self
|
|
|
|
|
```
|
|
|
|
|
3. Clone Borepin
|
|
|
|
|
```shell
|
|
|
|
|
$ git clone https://gitlab.com/fabinfra/fabaccess/client.git --recurse-submodules
|
2020-10-18 22:24:10 +00:00
|
|
|
```
|
|
|
|
|
|
2021-02-05 17:15:40 +00:00
|
|
|
4. Build Borepin
|
2020-10-18 22:24:10 +00:00
|
|
|
```shell
|
|
|
|
|
$ cd client
|
2021-02-05 17:15:40 +00:00
|
|
|
$ nuget restore
|
2020-10-18 22:24:10 +00:00
|
|
|
$ msbuild -t:Borepin_GTK
|
|
|
|
|
```
|
|
|
|
|
4. Run Borepin
|
|
|
|
|
```shell
|
|
|
|
|
$ mono ./Borepin/Borepin.GTK/bin/Debug/Borepin.GTK.exe
|
|
|
|
|
```
|
|
|
|
|
You can also use Rider or monodevelop as an IDE for development on Borepin
|
|
|
|
|
|
2021-02-05 17:15:40 +00:00
|
|
|
# UI
|
2021-02-05 17:17:10 +00:00
|
|
|
We use [Xamarin](https://dotnet.microsoft.com/apps/xamarin) for our UI Implementation.
|
2021-02-05 17:15:40 +00:00
|
|
|
|
|
|
|
|
## Frameworks
|
|
|
|
|
We use [Prism Libary](https://prismlibrary.com/docs/xamarin-forms/Getting-Started.html) for MVVM and navigation managment.
|
|
|
|
|
|
|
|
|
|
# Testing
|
2020-10-18 22:24:10 +00:00
|
|
|
We use [NUnit](https://nunit.org/) for testing.
|
