AcknowList

Acknowlist

Экран «Благодарности» отображает список лицензий, например, от зависимости кокопод и Swift Package Manager.

Также доступен в Objective-C с vtacknowledgementsviewcontroller.

Функции

• Загрузите подтверждения из файлов, сгенерированных кокоаподами ( Pods-###-acknowledgements.plist )
• Загрузите подтверждения из файлов Swift Package Manager ( Package.resolved )
• Принесите лицензии SPM от GitHub API
• Удалить ненужные перерывы на линии из лицензий для лучшей обертывания текста
• Дополнительный заголовок списка и нижний колонтитул
• Связанные ссылки в заголовке, нижнем колонтитуле и тексте подтверждения
• Поддержка раскадровки
• Поддержка темного режима
• Поддержка динамического типа
• Локализован на 13 языках
• Uikit и swiftui интерфейсы

Установка

Кокопод

1. Добавьте pod 'AcknowList' в свой Podfile .
2. Запустите pod install .
3. Добавьте Pods-#target#-acknowledgements.plist Файл, сгенерированный CoCoApods, к вашей основной цели: перетащите и оставьте файл из Pods/Target Support Files/Pods-#target#/ Папка в свой проект xcode (не копируйте файл, оставьте Copy items if needed без проверки).

Swift Package Manager

Acknowlist может быть установлен с помощью диспетчера пакетов Swift (требуется Xcode 12 для локализованных ресурсов).

1. Нажмите на File → Add Packages… .
2. Введите https://github.com/vtourraine/AcknowList .
3. Выберите версию, которую вы хотите использовать.
4. Добавьте файл Package.resolved , сгенерированный XCODE в вашу основную цель. Перетащите и оставьте файл из папки в свой проект XCode (не копируйте файл, оставьте Copy items if needed не контролировано).
   • Для однократных проектов Xcode файл находится в [appName].xcodeproj/project.xcworkspace/xcshareddata/swiftpm/
   • Для рабочих пространств Xcode (например, с кокоподами) файл находится в [appName].xcworkspace/xcshareddata/swiftpm/

Инициализация

Экземпляр AcknowListViewController обычно подталкивается к существующему UINavigationController .

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

По умолчанию контроллер попытается загрузить подтверждения из файла PLIST Cocoapods (угадая его местоположение на основе имени пакета), а также из файла 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

Acknowlist теперь предлагает интерфейс Swiftui, который поддерживает все основные платформы.

Создайте AcknowListSwiftUIView с путем к файлу plist или с помощью массива экземпляров Acknow , и представьте это представление из 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+

️ Если вы установите Acknowist с помощью Cocoapods или Swift Package Manager, это потребует iOS 13 и TVOS 13. Для поддержки более ранних версий импортируйте эту библиотеку вручную и игнорируйте классы Swiftui. В качестве альтернативы используйте vtacknowledgementsviewcontroller.

Требования

Acknowlist написан в Swift 5 и требует Xcode 12 и выше.

Кредиты

Acknowlist был создан Винсентом Туррейном и улучшился растущим списком участников.

Лицензия

Acknowlist доступен по лицензии MIT. См. Файл LICENSE.txt для получения дополнительной информации.