AcknowList

Ackniste

Écran Remerciements Affichage d'une liste de licences, par exemple à partir de cocoapods et de dépendances Swift Package Manager.

Également disponible dans Objective-C avec vtackNowledGlementsViewController.

Caractéristiques

• Chargez des remerciements de fichiers générés par Cocoapods ( Pods-###-acknowledgements.plist )
• Chargez des remerciements à partir de fichiers Swift Package Manager ( Package.resolved )
• Répondre aux licences SPM manquantes de l'API GitHub
• Supprimer les pauses de ligne inutiles des licences pour un meilleur emballage de texte
• En-tête de liste et pied de page facultatif
• Liens tappables dans l'en-tête, le pied de page et le texte de la reconnaissance
• Support de storyboard
• Support en mode noir
• Support de type dynamique
• Localisé en 13 langues
• Interfaces Uikit et Swiftui

Installation

Cocoapodes

1. Ajoutez pod 'AcknowList' à votre Podfile .
2. Exécutez pod install .
3. Ajoutez les Pods-#target#-acknowledgements.plist Fichier généré par Cocoapods à votre cible principale: faites glisser et déposez le fichier à partir des Pods/Target Support Files/Pods-#target#/ dossier à votre projet Xcode (ne copiez pas le fichier, laissez Copy items if needed décoché).

Swift Package Manager

ACKNOLLIST peut être installé avec le Swift Package Manager (nécessite XCode 12 pour les ressources localisées).

1. Cliquez sur File → Add Packages… .
2. Entrez https://github.com/vtourraine/AcknowList .
3. Sélectionnez la version que vous souhaitez utiliser.
4. Ajoutez le fichier Package.resolved généré par Xcode à votre cible principale. Faites glisser et déposez le fichier du dossier vers votre projet Xcode (ne copiez pas le fichier, laissez Copy items if needed sans cochond).
   • Pour les projets Xcode uniques, le fichier est dans [appName].xcodeproj/project.xcworkspace/xcshareddata/swiftpm/
   • Pour Xcode Workspaces (par exemple avec CocoAPods), le fichier est dans [appName].xcworkspace/xcshareddata/swiftpm/

Initialisation

L'instance AcknowListViewController est généralement poussée vers un UINavigationController existant.

 let viewController = AcknowListViewController ( )
navigationController . pushViewController ( viewController , animated : true )

Par défaut, le contrôleur essaiera de charger des remerciements à partir d'un fichier Plist Cocoapods (en devinant son emplacement en fonction du nom du bundle), ainsi que dans un fichier Package.resolved .

Vous pouvez également initialiser le contrôleur de vue avec un nom de fichier personnalisé ou une URL.

 let viewController = AcknowListViewController ( fileNamed : " Pods-AcknowExample-acknowledgements " ) 

 let url = Bundle . main . url ( forResource : " Pods-AcknowExample-acknowledgements " , withExtension : " plist " )
let viewController = AcknowListViewController ( plistFileURL : url )

Si vous souhaitez inclure Acknow licences qui ne font pas partie d'un fichier .plist ou .resolved

 let acknow = Acknow ( title : " ... " , text : " ... " )
let viewController = AcknowListViewController ( acknowledgements : [ acknow ] ) 

Personnalisation

Le contrôleur peut également afficher un en-tête et un pied de page. Par défaut, ils sont chargés à partir du fichier plist généré, mais vous pouvez également modifier directement les valeurs des propriétés.

viewController . headerText = " We love open source software. "
viewController . footerText = " Powered by CocoaPods and SPM "

Le titre du contrôleur est une valeur localisée pour les «remerciements». Vous voudrez peut-être utiliser cette valeur localisée pour le bouton présentant le contrôleur.

button . setTitle ( AcknowLocalization . localizedTitle ( ) , for : . normal )

Par défaut, AcknowListViewController utilise le style de vue de table «groupé». Vous pouvez choisir un style différent:

 let viewController = AcknowListViewController ( plistFileURL : url , style : . plain )

Si vous devez personnaliser davantage l'apparence ou le comportement de cette bibliothèque, n'hésitez pas à sous-classe ses classes.

Swiftui

ACKNOLLIST propose désormais une interface Swiftui, qui prend en charge toutes les principales plates-formes.

Instancier un AcknowListSwiftUIView avec un chemin vers le fichier plist , ou avec un tableau d'instances Acknow , et présenter cette vue à partir d'un NavigationView .

Plates-formes

Plate-forme	Uikit	Swiftui
	iOS 9.0+	iOS 13.0+
	tvos 9.0+	tvos 13.0+
?	VisionOS 1.0+	VisionOS 1.0+
⌚️	non pris en charge	watchos 7.0+
	non pris en charge	macOS 10.15+

️ Si vous installez AcKnowlist avec Cocoapods ou Swift Package Manager, il faudra iOS 13 et TVOS 13. Pour prendre en charge les versions antérieures, veuillez importer cette bibliothèque manuellement et ignorer les classes Swiftui. Alternativement, utilisez plutôt vtackNowledGlementsViewController.

Exigences

ACKNOLLIST est écrit dans Swift 5 et nécessite Xcode 12 et plus.

Crédits

Acknist a été créé par Vincent Tourraine et amélioré par une liste croissante de contributeurs.

Licence

ACKNOLLIST est disponible sous la licence MIT. Voir le fichier LICENSE.txt pour plus d'informations.