1 sur 9

Papillon - Développeurs

Bienvenue

Papillon est une application ouverte à tous ceux qui veulent s'impliquer. Rejoignez-nous pour contribuer au développement du projet !

Cette documentation est en cours de réécriture progressive, nous vous invitons à venir régulièrement pour voir les avancements!

Le projet est conçu pour être simple et accessible, même aux débutants, avec des composants et des documentations imaginées pour vous.

Commencer avec papillon

Préparer l'environnement de développement

Papillon est écrit en TypeScript avec React Native et Expo. Nous utilisons GitHub comme hébergeur du code de l'application.

Prérequis

Pour commencer à développer Papillon vous avez besoin des outils suivants:

Une fork de Papillon

Installation du repo

Ce script effectue un clonage du dépôt git de Papillon auquel vous ne pouvez pas effectuer de changements, c'est pour cela qu'il vous faut remplacer l'url après clone par celle de votre fork que vous avez créé précédemment.

git clone git@github.com:PapillonApp/Papillon.git
cd Papillon
npm install

git clone git@github.com:PapillonApp/Papillon.git
cd Papillon
pnpm install

git clone git@github.com:PapillonApp/Papillon.git
cd Papillon
yarn install

git clone git@github.com:PapillonApp/Papillon.git
cd Papillon
bun install

Et voilà vous avez maintenant votre propre version de Papillon

Vers l'infini et l'au delà...!

La seule limite est votre imagination!

Tester avec Expo Go

Expo Go permet de tester le bon fonctionnement de l’app avec vos modifications avant de le compiler.

Les fonctionnalités natives ne sont pas supportées sur Expo Go et vos appareils doivent être sur le même réseau.

Prérequis

Le dépot git de Papillon.

Utilisation

Lancer le serveur de développement

npm start

pnpm start

yarn start

bun start

Sanner le QR Code qui s'affiche à l'écran qui vous redigera vers l'application Expo Go qui chargera ensuite l'application.

Structure

Compiler Papilon

Pour iOS

Pour compiler Papillon pour iOS, vous devez posséder un Mac.

Prébuild du projet

Dans la racine du projet, éxecutez l'une de ces commandes :

npm run prebuild

pnpm prebuild

yarn prebuild

bun prebuild

Ouverture d'xCode

Ouvrir Papillon.xcworkspace avec xCode (TRÈS IMPORTANT)

Configuration de Signing

Si vous n'avez pas de compte payant Apple Developer: changer les teams pour le signing et enlever les "Assiocated Domains"

Selection du schemes et de la target

Sélectionner Papillon (release)au niveau des schemes et votre target (physique ou simulateur)

C'est terminé !

Attendre un peu et c'est tout bon!

Pour Android

Avec EAS

Préparer l'environnement de développement

Papillon est écrit en TypeScript avec React Native et Expo. Nous utilisons GitHub comme hébergeur du code de l'application.

Prérequis

Pour commencer à développer Papillon vous avez besoin des outils suivants:

Git ()
NodeJS ()
xCode, si vous comptez
Une fork de Papillon
Un IDE comme VSCode ()

Installation du repo

git clone git@github.com:PapillonApp/Papillon.git
cd Papillon
npm install

git clone git@github.com:PapillonApp/Papillon.git
cd Papillon
pnpm install

git clone git@github.com:PapillonApp/Papillon.git
cd Papillon
yarn install

git clone git@github.com:PapillonApp/Papillon.git
cd Papillon
bun install

Et voilà vous avez maintenant votre propre version de Papillon

Vers l'infini et l'au delà...!

Voilà! Vous avez une copie locale de Papillon prête à être améliorée par vos soins, pourquoi ne pas jeter un coup d'œuil à comment ou en apprendre un peu plus sur la ?

La seule limite est votre imagination!

Tester avec Expo Go

Expo Go permet de tester le bon fonctionnement de l’app avec vos modifications avant de le compiler.

Les fonctionnalités natives ne sont pas supportées sur Expo Go et vos appareils doivent être sur le même réseau.

Prérequis

L'application « Expo Go » (disponible sur ou sur ).
Le dépot git de Papillon.

Utilisation

Lancer le serveur de développement

npm start

pnpm start

yarn start

bun start

Sanner le QR Code qui s'affiche à l'écran qui vous redigera vers l'application Expo Go qui chargera ensuite l'application.

Pour iOS

Pour compiler Papillon pour iOS, vous devez posséder un Mac.

Prébuild du projet

Dans la racine du projet, éxecutez l'une de ces commandes :

npm run prebuild

pnpm prebuild

yarn prebuild

bun prebuild

Ouverture d'xCode

Ouvrir Papillon.xcworkspace avec xCode (TRÈS IMPORTANT)

Configuration de Signing

Si vous n'avez pas de compte payant Apple Developer: changer les teams pour le signing et enlever les "Assiocated Domains"

Selection du schemes et de la target

Sélectionner Papillon (release)au niveau des schemes et votre target (physique ou simulateur)

C'est terminé !

Attendre un peu et c'est tout bon!