foodcoop-mobile-app

KO | EN

gitlite — search

#python #hacktoberfest #react #ai #llm #android #rust #deep-learning #nodejs #java #kubernetes #security #mcp #ios

foodcoop-mobile-app

(★ 12)

L'application mobile des foodcoops

foodcoop-mobile-app Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# README

[![FOSSA Status](https://app.fossa.com/api/projects/git%2Bgithub.com%2Fdehy%2Ffoodcoop-mobile-app.svg?type=shield)](https://app.fossa.com/projects/git%2Bgithub.com%2Fdehy%2Ffoodcoop-mobile-app?ref=badge_shield)
[![Quality Gate Status](https://sonarcloud.io/api/project_badges/measure?project=dehy_foodcoop-mobile-app&metric=alert_status)](https://sonarcloud.io/summary/new_code?id=dehy_foodcoop-mobile-app)
[![Maintainability Rating](https://sonarcloud.io/api/project_badges/measure?project=dehy_foodcoop-mobile-app&metric=sqale_rating)](https://sonarcloud.io/summary/new_code?id=dehy_foodcoop-mobile-app)
[![ESLint](https://github.com/dehy/foodcoop-mobile-app/actions/workflows/eslint.yml/badge.svg)](https://github.com/dehy/foodcoop-mobile-app/actions/workflows/eslint.yml)
[![Typescript Compilation Errors](https://github.com/dehy/foodcoop-mobile-app/actions/workflows/tsc.yml/badge.svg)](https://github.com/dehy/foodcoop-mobile-app/actions/workflows/tsc.yml)

## Développement

L'application Supercoop est développé en React Native. Le projet utilise les langages Typescript (TSX), CSS, Objective-C (projet iOS), et Java (projet Android).

### Onboarding

#### Pré-requis

-   [Yarn](https://yarnpkg.com/getting-started/install) - gestionnaire des librairies javascript
-   IDE de votre choix (ex. [Visual Studio Code](https://code.visualstudio.com/))
-   Plugin [ESLint](https://eslint.org/) pour votre IDE ([ESLint pour VScode](https://marketplace.visualstudio.com/items?itemName=dbaeumer.vscode-eslint))

_Android_

-   [Android Studio](https://developer.android.com/studio) - environnement de développement android
-   Un appareil Android (>= 4.4)

_iOS_

-   un mac
-   [Xcode](https://apps.apple.com/fr/app/xcode/id497799835?mt=12) - environnement de développement iOS
-   [Cocoapods](https://cocoapods.org/) - gestionnaire de dépendances iOS
-   Un appareil iOS (>= 9.0)

_Bonus (facultatif)_

-   [Genymotion](https://www.genymotion.com/download/) - simulateur android tierce-partie

#### Commun

##### Installer les dépendances Javascript

```sh
$ yarn install
```

#### Linting / Formattage

ESLint est le linter utilisé dans ce projet. Prettier est le formatteur. Tous deux sont déjà installés en dépendances et configurés (`.eslintrs.js` et `.prettierrc.js`). Cependant, vous avez besoin d'un plugin ESLint pour votre IDE afin que celui-çi lise la configuration et exécute le formattage.

#### Développement Android

Suivre la documentation d'installation d'environnement: https://reactnative.dev/docs/environment-setup

Ouvrir ensuite le dossier `./android` avec Android Studio.

##### Dépendances natives

Tout comme pour iOS, Android nécessite des librairies natives. Elle sont gérées par Gradle (intégré à Android Studio). Ces librairies sont locales (dans node_modules/) mais doivent être installée/synchronisée. Grâce à Gradle, les versions des librairies natives sont gérées automatiquement.

##### Simulateur Android avec Genymotion (facultatif)

Une fois Genymotion installé (compte créé et identification effectuée), créer un nouveau terminal virtuel. Choisir par exemple un Samsung Galaxy S9 sous android 8.0 et laisser les paramètres par défaut.

##### Périphérique Android natif

Pour pouvoir utiliser l'application en mode dev sur votre périphérique Android, vous devez le passer en mode Développeur : sur votre smartphone android, rendez-vous dans l'application Paramètres > À propos du téléphone puis tapez 10 fois sur la ligne "Numéro de build".

Dans les paramètres, aller ensuite dans la section "Options pour développeurs" et activer le "Débogage USB".

Sur votre PC, exécuter en CLI la commande `adb reverse tcp:8081 tcp8081` afin que le périphérique android puisse se connecter au serveur "Metro".

#### Développement iOS

Suivre la documentation d'installation d'environnement: https://reactnative.dev/docs/environment-setup

Ouvrir ensuite le fichier `./ios/Supercoop.xcworkspace` avec Xcode.

##### Dépendances natives

Tout comme pour Android, des librairies natives doivent être ajoutés au projet. Nous utilisons pour l'instant le gestionnaire de librairies `[Cocoapods](https://cocoapods.org/)`. Tout comme pour Android, elles sont disponibles localement avec les librairies Javascript (dans node_modules) mais doivent tout de même être installées/synchronisées après chaque mise à jour de librairie Javascript.

```sh
cd ios/
bundle exec pod update
```

#### Messages de commit

Les messages de commit doivent respecter la [Conventional Commits specification](https://www.conventionalcommits.org/en/v1.0.0/)

<type>[optional scope]: <description>

[optional body]

[optional footer(s)]

#### Configuration de l'app

La configuration de l'application (endpoint/identifiants Odoo, endpoint/paramètres OpenId Connect, ...) sont externalisé à l'application et sont disponible grâce à la mécanique `dotenv` :

Recopier le fichier `.env.dist` en fichier `.env` et y insérer les valeurs en face des variables.

Pour plus de détails et pour utiliser les fonctionnalités avancées de ce système, voir `[react-native-config](https://github.com/luggit/react-native-config)`

### Mise en prod

#### Versioning

Le versioning de l'application suit la méthode [Semantic Versioning](https://semver.org/) (MAJOR.MINOR.PATCH) où le chiffre MAJOR est fixé à 1 jusqu'à une réécriture complète de l'app.

MINOR est augmenté à chaque nouvelle fonctionnalité significative.

PATCH est augmenté à chaque mise à jour de bugs uniquement.

#### Déploiement en Beta

Le cycle de mise en prod de l'app doit systématiquement passer par une phase Beta. Chez Apple, cela s'appelle "Testflight", chez Google cela s'appelle simplement "Programme beta".

Il est possible de s'en occuper manuellement en suivant les procédures des deux plateformes.

#### APK pour les devices sans Google Play Store (MC40)

-   Récupérer le fichier AppBundle généré par Android Studio pour le Play Store (généralement `app-release.aab`)
-   Télécharger l'outil [bundletool](https://github.com/google/bundletool/releases) et exécuter la commande suivante :

java -jar bundletool-all-1.3.0.jar build-apks --bundle=app-release.aab --output=app-release.apks --overwrite --mode=universal --ks=/path/to/project/android/keystores/release.keystore --ks-pass=pass:my-keystore-password --ks-key-alias=sp_release --key-pass=pass:my-key-password

-   Changer l'extension du fichier `app-release.apks` en `.zip`. Dézipper et distribuer le fichier `universal.apk`.

### Base de donnée

#### Générer un script de migration SQL

Une entité a évolué et donc le schéma SQL aussi ? Il faut créer un nouveau script de migration SQL. Il sera créé dans `./src/migrations`.

```sh
$ ./node_modules/.bin/ts-node ./node_modules/.bin/typeorm migration:run
$ ./node_modules/.bin/ts-node ./node_modules/.bin/typeorm migration:generate -n '<Nom>'
```

Ajouter la classe fraîchement créée ('`<Nom><Timestamp>`') dans Database.ts, dans la méthode `createConnexion()` de la méthode `connect()`.

## Contribution

Les pull request sont les bienvenues. Pour des changements majeurs, merci d'ouvrir une issue d'abord afin de discuter des changements que vous souhaiteriez effectuer.

Merci de mettre à jour les tests appropriés (le cas échéant).

## License

[GNU General Public License v3.0 or later](https://choosealicense.com/licenses/gpl-3.0/)

[![FOSSA Status](https://app.fossa.com/api/projects/git%2Bgithub.com%2Fdehy%2Ffoodcoop-mobile-app.svg?type=large)](https://app.fossa.com/projects/git%2Bgithub.com%2Fdehy%2Ffoodcoop-mobile-app?ref=badge_large)

foodcoop-mobile-app

foodcoop-mobile-app Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

foodcoop-mobile-app

foodcoop-mobile-app Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README