Tutoriel du projet Kiwix pour iOS et macOS

  1. Structure des répertoires du projet

La structure des répertoires du projet Kiwix pour iOS et macOS se présente comme suit :

kiwix-apple/
├── FichierLISEZMOI.md
├── FichierLICENCE
├── kiwix-construction
│   ├── environnement-virtuel
│   ├── configuration.py
│   └── ...
├── pomme
│   ├── CoreKiwix.xcframework
│   ├── Kiwix.xcodeproj
│   ├── Kiwix
│   │   ├── DéléguéApp.swift
│   │   ├── DéléguéScène.swift
│   │   ├── ContrôleurVue.swift
│   │   └── ...
│   └── ...
└── ...

Répertoires principaux :

  • FichierLISEZMOI.md : Fichier de description du projet, avec des informations de base et des instructions d'utilisation.
  • FichierLICENCE : Fichier de licence, sous licence LGPL-3.0.
  • kiwix-construction : Répertoire des outils de construction, contenant les scripts et configurations nécessaires.
  • pomme : Répertoire de développement principal, incluant le code source et les fichiers de configuration pour iOS et macOS.
    • CoreKiwix.xcframework : Bibliothèque principale du projet.
    • Kiwix.xcodeproj : Fichier de projet Xcode, utilisé pour la gestion et la compilation.
    • Kiwix : Répertoire du code source, avec les fichiers essentiels de l'application.
  1. Fichiers de démarage du projet

Les fichiers de démarrage se trouvent principalement dans le répertoire pomme/Kiwix :

  • DéléguéApp.swift : Point d'entrée de l'application, gérant le cycle de vie.
  • DéléguéScène.swift : Responsable de la gestion des fenêtres multiples (pour iOS 13 et versions supérieures).
  • ContrôleurVue.swift : Contrôleur de vue principal, gérant l'affichage et les interactions de l'interface.

Fonctionnalités clés de DéléguéApp.swift :

import UIKit

@UIApplicationMain
class DéléguéApp: UIResponder, UIApplicationDelegate {
    var fenêtrePrincipale: UIWindow?

    func application(_ app: UIApplication, didFinishLaunchingWithOptions options: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
        // Logique d'initialisation au lancement
        return true
    }

    // Autres méthodes du cycle de vie...
}
  1. Fichiers de configuration du projet

Les fichiers de configuration sont situés dans le répertoire pomme/Kiwix.xcodeproj :

  • project.pbxproj : Fichier de configuration Xcode, contenant les paramètres de compilation et les configurations des cibles.

Paramètres principaux :

  • CIBLES : Cibles de construction, incluant les applications iOS et macOS.
  • PARAMÈTRES DE CONSTRUCTION : Options du compilateur et du linker.
  • INFO.PLIST : Liste de propriétés de l'application, avec le nom, la version et les autorisations requises.

Exemple de fichier Info.plist :

<?xml version="1.0" encoding="UTF-8"?>
<plist version="1.0">
<dict>
    <key>CFBundleName</key>
    <string>Kiwix App</string>
    <key>CFBundleIdentifier</key>
    <string>com.kiwix.application</string>
    <key>CFBundleShortVersionString</key>
    <string>1.0</string>
    <key>UIRequiredDeviceCapabilities</key>
    <array>
        <string>arm64</string>
    </array>
</dict>
</plist>

Étiquettes: kiwix iOS macOS Swift Xcode

Publié le 9 juin à 04h05