AcknowList

謝辞

謝辞画面ココアポッドやSwiftパッケージマネージャーの依存関係など、ライセンスのリストを表示します。

また、vtacknowledgementsViewControllerを搭載したObjective-Cでも利用できます。

特徴

• cocoapods生成されたファイルからの謝辞を読み込みます（ Pods-###-acknowledgements.plist ）
• Swift Package Managerファイルからの謝辞を読み込みます（ Package.resolved ）
• GitHub APIから欠落しているSPMライセンスを取得します
• より良いテキストラッピングのために、ライセンスから不要なラインブレークを削除する
• オプションのリストヘッダーとフッター
• ヘッダー、フッター、および確認テキストのタップ可能なリンク
• ストーリーボードのサポート
• ダークモードのサポート
• 動的タイプのサポート
• 13の言語でローカライズされています
• UikitとSwiftuiインターフェイス

インストール

cocoapods

1. Podfileにpod 'AcknowList'を追加します。
2. pod installを実行します。
3. Pods-#target#-acknowledgements.plistファイルココアポッドによって生成されたファイルメインターゲット： Pods/Target Support Files/Pods-#target#/フォルダーからファイルをXcodeプロジェクトにドラッグアンドドロップします（ファイルをコピーしないで、 Copy items if neededください）。

Swiftパッケージマネージャー

謝辞は、Swift Package Manager（ローカライズされたリソースにXcode 12が必要です）でインストールできます。

1. Fileをクリック→ Add Packages… 。
2. https://github.com/vtourraine/AcknowListを入力してください。
3. 使用するバージョンを選択します。
4. Xcodeによって生成されたPackage.resolvedファイルをメインターゲットに追加します。ファイルをフォルダーからXcodeプロジェクトにドラッグアンドドロップします（ファイルをコピーせず、 Copy items if neededを残します）。
   • 単一のXcodeプロジェクトの場合、ファイルは[appName].xcodeproj/project.xcworkspace/xcshareddata/swiftpm/
   • Xcode Workspaces（たとえば、ココアポッドを使用）の場合、ファイルは[appName].xcworkspace/xcshareddata/swiftpm/にあります。

初期化

AcknowListViewControllerインスタンスは通常、既存のUINavigationControllerにプッシュされます。

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

デフォルトでは、コントローラーは、ココアポッドプリストファイル（バンドル名に基づいてその場所を推測することにより）およびPackage.resolvedファイルから確認をロードしようとします。

カスタムファイル名またはURLでビューコントローラーを初期化することもできます。

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

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

.plistまたは.resolvedファイルの一部ではないライセンスを含めたい場合は、新しいAcknowインスタンスを作成し、コントローラーの謝辞配列にそれらを使用できます。

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

カスタマイズ

コントローラーは、ヘッダーとフッターを表示することもできます。デフォルトでは、生成されたplistファイルからロードされますが、プロパティ値を直接変更することもできます。

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

コントローラーのタイトルは、「謝辞」のローカライズされた値です。コントローラーを提示するボタンにこのローカライズされた値を使用することをお勧めします。

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

デフォルトでは、 AcknowListViewController 「グループ化された」テーブルビュースタイルを使用します。別のスタイルを選択できます。

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

このライブラリの外観または動作をさらにカスタマイズする必要がある場合は、クラスをサブクラス化してください。

Swiftui

謝辞は、すべての主要なプラットフォームをサポートするSwiftUIインターフェイスを提供するようになりました。

plistファイルへのパス、またはAcknowのAcknowListSwiftUIViewをインスタンス化し、 NavigationViewからこのビューを提示します。

プラットフォーム

プラットフォーム	uikit	Swiftui
	iOS 9.0+	iOS 13.0+
	TVOS 9.0+	TVOS 13.0+
？	Visionos 1.0+	Visionos 1.0+
⌚⌚️	サポートされていません	watchos 7.0+
	サポートされていません	MacOS 10.15+

ショ和CocoapodsまたはSwift Package Managerで謝辞をインストールする場合、iOS 13とTVOS 13が必要になります。以前のバージョンをサポートするには、このライブラリを手動でインポートし、Swiftuiクラスを無視してください。または、代わりにvtacknowledgementsviewcontrollerを使用します。

要件

謝辞はSwift 5で記述されており、Xcode 12以降が必要です。

クレジット

謝辞はVincent Tourraineによって作成され、貢献者の増加リストによって改善されました。

ライセンス

謝辞はMITライセンスの下で利用できます。詳細については、 LICENSE.txtファイルを参照してください。