Skip to content
This repository has been archived by the owner on Aug 22, 2024. It is now read-only.

Commit

Permalink
Merge pull request #43 from Sacha338/VidéoIOS
Browse files Browse the repository at this point in the history
feat : Ajout vidéo IOS + corrections orthographiques
  • Loading branch information
tom-theret authored Apr 25, 2024
2 parents 00077fc + 9243670 commit b4fcfd2
Show file tree
Hide file tree
Showing 2 changed files with 75 additions and 71 deletions.
Binary file added docs/assets/tuto/buildIOS.mp4
Binary file not shown.
146 changes: 75 additions & 71 deletions docs/development/app/ios.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,108 +5,112 @@
- [x] Des bases en JavaScript
- [x] Une connaissance du terminal de macOS

## Installation des dépendances
### Homebrew
[Homebrew](https://brew.sh/) est nécessaire pour installer le reste des outils nécessaires.
=== "Documentation"
## Installation des dépendances
### Homebrew
[Homebrew](https://brew.sh/) est nécessaire pour installer le reste des outils nécessaires.

Vous pouvez l'installer simplement en indiquant cette commande dans un terminal macOS :
Vous pouvez l'installer simplement en indiquant cette commande dans un terminal macOS :

```sh
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
```
### Node & Watchman
Si ce n'est pas déjà fait, installez Node.js et Watchmen
```sh
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
```

```sh
brew install node
brew install watchman
```
### Xcode
[Xcode](https://developer.apple.com/xcode/) est nécessaire pour développer sous iOS. Installez le depuis le [Mac App Store](https://apps.apple.com/us/app/xcode/id497799835?mt=12)
### Node & Watchman
Si ce n'est pas déjà fait, installez Node.js et Watchman

#### Outils de ligne de commande
Vous devez aussi installer les "Command Line Tools".
Ouvrez Xcode, puis dans **Préférences > Locations**, Sélectionnez la version la plus récente de Xcode dans l'onglet "Command Line Tools"
![Screenshot de Xcode](https://reactnative.dev/assets/images/GettingStartedXcodeCommandLineTools-8259be8d3ab8575bec2b71988163c850.png)
```sh
brew install node
brew install watchman
```
### Xcode
[Xcode](https://developer.apple.com/xcode/) est nécessaire pour développer sous iOS. Installez le depuis le [Mac App Store](https://apps.apple.com/us/app/xcode/id497799835?mt=12)

### CocoaPods
Pour terminer, il est nécessaire d'avoir CocoaPods d'installé pour les dépendances de l'app.
#### Outils de ligne de commande
Vous devez aussi installer les "Command Line Tools".
Ouvrez Xcode, puis dans **Préférences > Locations**, Sélectionnez la version la plus récente de Xcode dans l'onglet "Command Line Tools"
![Screenshot de Xcode](https://reactnative.dev/assets/images/GettingStartedXcodeCommandLineTools-8259be8d3ab8575bec2b71988163c850.png)

```sh
sudo gem install cocoapods
```
### CocoaPods
Pour terminer, il est nécessaire d'avoir CocoaPods d'installé pour les dépendances de l'app.

```sh
sudo gem install cocoapods
```

## Environnement
Commencez par cloner le [repo de Papillon](https://github.com/PapillonApp/Papillon) et mettre en place votre environnement de développement.
## Environnement
Commencez par cloner le [repo de Papillon](https://github.com/PapillonApp/Papillon) et mettre en place votre environnement de développement.

Une fois le repo cloné, installez simplement les packages npm liés :
Une fois le repo cloné, installez simplement les packages npm liés :

```
npm i
```
```
npm i
```

Il sera aussi nécessaire d'avoir [**Expo CLI**](https://docs.expo.dev/more/expo-cli/) :
Il sera aussi nécessaire d'avoir [**Expo CLI**](https://docs.expo.dev/more/expo-cli/) :

```
npm install -g expo-cli
```
```
npm install -g expo-cli
```

Vous devrez aussi installer les dépendances de [**Cocoapods**](https://cocoapods.org/) dans le dossier *`/ios`*:
Vous devrez aussi installer les dépendances de [**Cocoapods**](https://cocoapods.org/) dans le dossier *`/ios`*:

```
pod install
```
```
pod install
```

## Les devbuilds
Pour modifier Papillon et voir vos modifications, un "devbuild" est nécessaire.

## Les devbuilds
Pour modifier Papillon et voir vos modifications, un "devbuild" est nécessaire.
C'est une version spéciale de l'app qui se connecte à votre environnement de développement pour afficher vos changements en temps réel sans avoir à recompiler Papillon.

C'est une version spéciale de l'app qui se connecte à votre environnement de développement pour afficher vos changements en temps réel sans avoir à recompiler Papillon.
Pour commencer, modifiez le fichier **`app.json`** afin de modifier le nom de l'application ainsi que son package, pour éviter de remplacer la vraie appli.

Pour commencer, modifiez le fichier **`app.json`** afin de modifier le nom de l'application ainsi que son package, pour éviter de remplacer la vraie appli.
- Ligne 3, variable **`name`**: remplacer par le nom de votre choix (exemple "Papillon Dev").

- Ligne 3, variable **`name`**: remplacer par le nom de votre choix (exemple "Papillon Dev").
- Ligne 71, variable **`package`**: remplacer par exemple par **`xyz.getpapillon.app.dev`**. Ne pas changer cette variable entraînera une erreur à l'installation et un remplacement de l'appli officielle.

- Ligne 71, variable **`package`**: remplacer par exemple par **`xyz.getpapillon.app.dev`**. Ne pas changer cette variable entraînera une erreur à l'installation et un remplacement de l'appli officielle.
Pour installer une devbuild, rien de plus simple :

Pour installer une devbuild, rien de plus simple :
Commencez par **prébuilder** Papillon. On expliquera en quoi cela consiste plus tard. Cette étape est nécessaire avant chaque compilation de l'app

Commencez par **prébuilder** Papillon. On expliquera en quoi cela consiste plus tard. Cette étape est nécessaire avant chaque compilation de l'app
```
npx expo prebuild
```

```
npx expo prebuild
```
Une fois cela terminé, ouvrez Papillon dans Xcode en ouvrant le fichier *`/iOS/Papillon.xcworkspace`*.

Une fois cela terminé, ouvrez Papillon dans Xcode en ouvrant le fichier *`/iOS/Papillon.xcworkspace`*.
Vous n'avez plus qu'à démarrer l'app avec votre iPhone branché ou sur un simulateur iOS en sélectionnant un appareil et **en appuyant sur l'icône "Play" en haut de Xcode**.

Vous n'avez plus qu'à démarrer l'app avec votre iPhone branché ou sur un simulateur iOS en sélectionnant un appareil et **en appuyant sur l'icône "Play" en haut de Xcode**.
### Démarrer une session de développement
Une fois la prébuild installée, démarrez le serveur de développement via la commande suivante :

```
npx expo start
```

### Démarrer une session de développement
Une fois la prébuild installée, démarrez le serveur de développement via la commande suivante :
*(Vous n'êtes pas obligé de développer sur la même machine que celle qui a compilé la prébuild)*
Une fois la commande démarrée, ouvrez l'app de prebuild sur votre iPhone et indiquez l'adresse du serveur ou alors, scannez le QR-Code affiché dans la console depuis l'app Appareil photo

```
npx expo start
```
**(Vous devez avoir votre iPhone et votre ordinateur sur le même réseau local)**

*(Vous n'êtes pas obligé de développer sur la même machine que celle qui a compilé la prébuild)*
Une fois la commande démarrée, ouvrez l'app de prebuild sur votre iPhone et indiquez l'adresse du serveur ou alors, scannez le QR-Code affiché dans la console depuis l'app Appareil photo
## Les prébuilds
La fonction ***`prebuild`*** permet de préparer l'app a être compilée en code natif pour iOS, cela indique :
- Empaqueter les icônes, images, polices, et autres fichiers de l'app
- Installer automatiquement les pods et modules de Papillon
- Mettre a jour certaines parties natives de l'app.

**(Vous devez avoir votre iPhone et votre ordinateur sur le même réseau local)**
Tout cela se fait simplement et automatiquement avec une commande :

## Les prébuilds
La fonction ***`prebuild`*** permet de préparer l'app a être compilée en code natif pour iOS, cela indique :
- Empaqueter les icônes, images, polices, et autres fichiers de l'app
- Installer automatiquement les pods et modules de Papillon
- Mettre a jour certaines parties natives de l'app.
```
npx expo prebuild
```

Tout cela se fait simplement et automatiquement avec une commande :
Une fois effectuée, vous pouvez archiver ou démarrer l'app comme d'habitude.

```
npx expo prebuild
```
## Compiler une version "release"
Normalement, cela n'est pas nécessaire, mais vous pouvez créer une version release (donc indépendante) telle que vous l'obtiendrez sur l'App Store en utilisant l'option **Archive** sur Xcode.

Une fois effectuée, vous pouvez archiver ou démarrer l'app comme d'habitude.
=== "Tutoriel vidéo"

## Compiler une version "release"
Normalement, cela n'est pas nécessaire, mais vous pouvez créer une version release (donc indépendante) telle que vous l'obtiendrez sur l'App Store en utilisant l'option **Archive** sur Xcode.
<video controls src="../../assets/tuto/buildIOS.mp4" title="Comment build l'app sous IOS"></video>

0 comments on commit b4fcfd2

Please sign in to comment.