2021-01-09 11:03:41 +01:00
|
|
|
# Ğecko
|
2020-12-13 05:43:52 +01:00
|
|
|
|
2023-03-01 11:47:02 +01:00
|
|
|
Ğecko is a transaction client owned by [Axiom-Team association] and written in Dart. It is fast and
|
|
|
|
secure thanks to native code compilation. It is not intended to manage member accounts, but rather
|
|
|
|
simple wallets.
|
2020-12-13 05:43:52 +01:00
|
|
|
|
2023-03-01 11:47:02 +01:00
|
|
|
The development is quite early, you can participate in the
|
|
|
|
discussion [on the Duniter forum](https://forum.duniter.org/t/gecko-nouveau-client-de-paiements-1-sur-mobile-en-cours-de-developpement-dart-flutter/7857) (
|
|
|
|
mostly FR)
|
2020-12-15 13:00:48 +01:00
|
|
|
|
2021-04-01 23:45:12 +02:00
|
|
|
[Axiom-Team association]: https://axiom-team.fr/
|
|
|
|
|
2021-02-10 20:15:21 +01:00
|
|
|
## Getting Started
|
2020-12-15 13:00:48 +01:00
|
|
|
|
2021-01-09 11:03:41 +01:00
|
|
|
<div align="center">
|
|
|
|
|
2022-06-16 01:40:47 +02:00
|
|
|
![Demo Gif](https://git.duniter.org/clients/gecko/-/raw/master/images/demo-0.0.9+2.gif)
|
2021-01-09 11:03:41 +01:00
|
|
|
|
|
|
|
<br><br>
|
2021-02-10 20:15:21 +01:00
|
|
|
</div>
|
|
|
|
|
|
|
|
## Develop
|
|
|
|
|
|
|
|
To contribute to the code, we advise you to install the following development environment.
|
|
|
|
|
|
|
|
1. Android Studio
|
2023-03-01 11:47:02 +01:00
|
|
|
|
|
|
|
- Android VM
|
|
|
|
- Android NDK
|
|
|
|
|
2021-02-10 20:15:21 +01:00
|
|
|
1. Flutter SDK
|
|
|
|
1. VSCode/Codium Flutter extension
|
|
|
|
|
2023-03-01 11:47:02 +01:00
|
|
|
This will take about 12GB on your drive and 30 min of your time (with a good connection). Don't
|
|
|
|
hesitate to ask on the forum for a peer-coding session if you are stuck.
|
2021-02-10 20:15:21 +01:00
|
|
|
|
|
|
|
### Android Studio
|
|
|
|
|
|
|
|
Android Studio will let you set up an Android VM and install tools you need.
|
|
|
|
|
2023-03-01 11:47:02 +01:00
|
|
|
- Install [Android Studio](https://developer.android.com/studio/) using your favorite installation
|
|
|
|
method.
|
2021-02-10 20:15:21 +01:00
|
|
|
- At startup, do not open a project but click "configure" at the bottom of the "Welcome" menu
|
|
|
|
- In "SDK Manager"
|
|
|
|
- SDK Platforms Ttab
|
|
|
|
- note your SDK folder location (later used for Rust environment variables)
|
|
|
|
- select Android 11 (R) API level 30 (default)
|
|
|
|
- SDK Tools
|
|
|
|
- select NDK (native development kit used to compile Rust to native target)
|
|
|
|
- In "AVD Manager"
|
|
|
|
- create a virtual machine (ours is Pixel 4 32bits machine)
|
|
|
|
- launch it in the emulator
|
|
|
|
|
|
|
|
If you reach this point without trouble, you're good to go for the next step.
|
|
|
|
|
|
|
|
### Flutter SDK
|
|
|
|
|
2023-03-01 11:47:02 +01:00
|
|
|
Flutter is a powerfull SDK to develop Android
|
|
|
|
apps. [Install it](https://flutter.dev/docs/get-started/install/linux) with your favorite
|
|
|
|
installation method.
|
2021-02-10 20:15:21 +01:00
|
|
|
|
|
|
|
### VSCode
|
|
|
|
|
2023-03-01 11:47:02 +01:00
|
|
|
We are using VSCode and therefore document the process for this IDE. Of course you're free to use
|
|
|
|
whatever you want.
|
|
|
|
Clone the ğecko repo and open a dart file (e.g. `lib/main.dart`). VSCode will suggest you to insall
|
|
|
|
relevant extensions.
|
2021-02-10 20:15:21 +01:00
|
|
|
|
|
|
|
### Build the app
|
|
|
|
|
2023-03-01 11:47:02 +01:00
|
|
|
In a dart file (e.g. `lib/main.dart`), type the `F5` key to build the code. The app should open
|
|
|
|
automatically in your VM which is running.
|
2021-04-19 23:52:44 +02:00
|
|
|
|
|
|
|
### Build your app for Desktop
|
|
|
|
|
|
|
|
#### Linux
|
|
|
|
|
2021-12-19 21:05:04 +01:00
|
|
|
Install dependancies:
|
|
|
|
|
|
|
|
`sudo apt-get install clang cmake ninja-build pkg-config libgtk-3-dev`
|
|
|
|
|
|
|
|
Then build debug for linux:
|
2021-04-19 23:52:44 +02:00
|
|
|
|
|
|
|
`flutter run -d linux`
|
|
|
|
|
2021-12-19 21:05:04 +01:00
|
|
|
If you get this error:
|
|
|
|
|
|
|
|
```
|
|
|
|
flutter /usr/share/cmake-3.16/Modules/FindPkgConfig.cmake:643 (_pkg_check_modules_internal)
|
|
|
|
```
|
|
|
|
|
|
|
|
Please try:
|
|
|
|
|
|
|
|
`sudo apt install liblzma-dev`
|
|
|
|
|
|
|
|
then
|
|
|
|
|
|
|
|
`flutter clean && flutter run -d linux`
|
|
|
|
|
2021-05-31 22:00:27 +02:00
|
|
|
## Roadmap
|
|
|
|
|
2022-06-10 23:16:42 +02:00
|
|
|
-> https://pad.p2p.legal/gecko-roadmap-2022?view
|