AcknowList

Acknowler

ANERKENNUNGSBREISUNGSBREISUNG Zeigen Sie eine Liste von Lizenzen an, beispielsweise von Cocoapods und Swift -Paket -Manager -Abhängigkeiten.

Auch in Objective-C mit vtacknowledGementsViewController erhältlich.

Merkmale

• Lastanerkennung aus Cocoapods generierten Dateien ( Pods-###-acknowledgements.plist )
• Laden Sie Bestätigungen aus Swift -Paket -Manager -Dateien ( Package.resolved ).
• Fehlen Sie fehlende SPM -Lizenzen von Github API
• Entfernen Sie unnötige Zeilenumbrüche aus Lizenzen für eine bessere Textverpackung
• Optionale Listenheader und Fußzeile
• Tappable Links in Header-, Fußzeile und Bestätigungstext
• Storyboard -Unterstützung
• Dunkelmodusunterstützung
• Dynamischer Typunterstützung
• In 13 Sprachen lokalisiert
• Uikit- und Swiftui -Schnittstellen

Installation

Cocoapods

1. Fügen Sie pod 'AcknowList' zu Ihrem Podfile hinzu.
2. pod install ausführen.
3. Fügen Sie die von Cocoapods generierte Pods-#target#-acknowledgements.plist -Datei hinzu: Ziehen Sie die Datei aus den Pods/Target Support Files/Pods-#target#/ Ordner in Ihr XCode-Projekt ab (kopieren Sie die Datei nicht, lassen Sie Copy items if needed nicht mehr verstopft).

Swift Package Manager

AcKnowlist kann mit dem Swift -Paket -Manager installiert werden (erfordert Xcode 12 für lokalisierte Ressourcen).

1. Klicken Sie auf File → Add Packages… .
2. Geben Sie https://github.com/vtourraine/AcknowList ein.
3. Wählen Sie die Version aus, die Sie verwenden möchten.
4. Fügen Sie die von Xcode generierte Datei Package.resolved . Ziehen Sie die Datei aus dem Ordner in Ihr XCode -Projekt ab (kopieren Sie die Datei nicht und lassen Sie Copy items if needed nicht kontrolliert).
   • Für einzelne Xcode -Projekte befindet sich die Datei in [appName].xcodeproj/project.xcworkspace/xcshareddata/swiftpm/
   • Für Xcode -Arbeitsbereiche (zum Beispiel mit Cocoapods) befindet sich die Datei in [appName].xcworkspace/xcshareddata/swiftpm/

Initialisierung

Die AcknowListViewController -Instanz wird normalerweise zu einem vorhandenen UINavigationController geführt.

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

Standardmäßig versucht der Controller, Bestätigungen aus einer Cocoapods -Plist -Datei (indem er seinen Speicherort basierend auf dem Bündelnamen erraten) sowie aus einer Package.resolved Datei.

Sie können den Ansichtscontroller auch mit einem benutzerdefinierten Dateinamen oder einer URL initialisieren.

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

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

Wenn Sie Lizenzen einfügen möchten, die nicht Teil einer .plist oder .resolved Datei sind, können Sie neue Acknow erstellen und für das Bestätigungs -Array des Controllers verwenden.

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

Anpassung

Der Controller kann auch einen Header und eine Fußzeile anzeigen. Standardmäßig werden sie aus der generierten plist -Datei geladen, Sie können jedoch auch die Eigenschaftenwerte direkt ändern.

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

Der Controller -Titel ist ein lokalisierter Wert für „Anerkennung“. Möglicherweise möchten Sie diesen lokalisierten Wert für die Taste verwenden, die den Controller präsentiert.

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

Standardmäßig verwendet AcknowListViewController den "gruppierten" Tabellenansichtsstil. Sie können einen anderen Stil wählen:

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

Wenn Sie das Erscheinungsbild oder das Verhalten dieser Bibliothek weiter anpassen müssen, können Sie ihre Klassen freiklassen.

Swiftui

AcKnowlist bietet jetzt eine Swiftui -Schnittstelle an, die alle wichtigen Plattformen unterstützt.

Instantieren Sie eine AcknowListSwiftUIView mit einem Pfad zur plist -Datei oder mit einer Reihe von Acknow und präsentieren Sie diese Ansicht aus einer NavigationView .

Plattformen

Plattform	Uikit	Swiftui
	iOS 9.0+	iOS 13.0+
	TVOS 9.0+	TVOS 13.0+
?	Visionos 1.0+	Visionos 1.0+
⌚️	nicht unterstützt	watchos 7.0+
	nicht unterstützt	macOS 10.15+

Euen Wenn Sie AcKnowlist mit Cocoapods oder Swift -Paketmanager installieren, müssen iOS 13 und TVOS 13 verwendet werden. Um frühere Versionen zu unterstützen, importieren Sie diese Bibliothek manuell und ignorieren die Swiftui -Kurse. Verwenden Sie alternativ stattdessen vtacknowledGementsViewController.

Anforderungen

AcKlowist ist in Swift 5 geschrieben und benötigt Xcode 12 und höher.

Credits

AcKlowist wurde von Vincent Tourraine geschaffen und durch eine wachsende Liste von Mitwirkenden verbessert.

Lizenz

AcKnowlist ist im Rahmen der MIT -Lizenz erhältlich. Weitere Informationen finden Sie in der Datei LICENSE.txt .