AcknowList

Actanio

Pantalla de reconocimiento que muestra una lista de licencias, por ejemplo, de las dependencias de Cocoapods y Swift Package Manager.

También disponible en Objective-C con VTacknowledgementsViewController.

Características

• Cargar Agradecimientos de archivos generados por Cocoapods ( Pods-###-acknowledgements.plist )
• Cargue los reconocimientos de los archivos de Swift Package Manager ( Package.resolved )
• Obtenga licencias SPM faltantes de la API de GitHub
• Eliminar los descansos de línea innecesarios de las licencias para una mejor envoltura de texto
• Encabezado y pie de página de la lista opcional
• Enlaces TapPables en encabezado, pie de página y texto de reconocimiento
• Soporte de guión gráfico
• Soporte en modo oscuro
• Soporte de tipo dinámico
• Localizado en 13 idiomas
• Interfaces Uikit y Swiftui

Instalación

Cocoapods

1. Agregue pod 'AcknowList' a su Podfile .
2. Ejecutar pod install .
3. Agregue el archivo Pods-#target#-acknowledgements.plist generado por Cocoapods a su objetivo principal: arrastre y suelte el archivo de los Pods/Target Support Files/Pods-#target#/ carpeta a su proyecto xcode (no copie el archivo, deje Copy items if needed ).

Administrador de paquetes Swift

Acknowlist se puede instalar con el Swift Package Manager (requiere Xcode 12 para recursos localizados).

1. Haga clic en File → Add Packages… .
2. Ingrese https://github.com/vtourraine/AcknowList .
3. Seleccione la versión que desea usar.
4. Agregue el archivo Package.resolved generado por XCode a su objetivo principal. Arrastre y suelte el archivo de la carpeta a su proyecto Xcode (no copie el archivo, deje Copy items if needed no verificarse).
   • Para proyectos de XCode únicos, el archivo está en [appName].xcodeproj/project.xcworkspace/xcshareddata/swiftpm/
   • Para los espacios de trabajo de XCode (por ejemplo con Cocoapods), el archivo está en [appName].xcworkspace/xcshareddata/swiftpm/

Inicialización

La instancia AcknowListViewController generalmente se lleva a un UINavigationController existente.

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

De manera predeterminada, el controlador intentará cargar reconocimientos desde un archivo de Cocoapods Plist (adivinando su ubicación en función del nombre del paquete), así como desde un archivo Package.resolved .

También puede inicializar el controlador de vista con un nombre de archivo o URL personalizado.

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

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

Si desea incluir licencias que no formen parte de un archivo .plist o .resolved , puede crear nuevas instancias Acknow y usarlas para la matriz de reconocimientos del controlador.

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

Personalización

El controlador también puede mostrar un encabezado y un pie de página. Por defecto, se cargan desde el archivo plist generado, pero también puede cambiar directamente los valores de propiedades.

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

El título del controlador es un valor localizado para "Agradecimientos". Es posible que desee utilizar este valor localizado para el botón que presenta el controlador.

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

De forma predeterminada, AcknowListViewController utiliza el estilo de vista de tabla "agrupado". Puedes elegir un estilo diferente:

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

Si necesita personalizar aún más la apariencia o el comportamiento de esta biblioteca, no dude en subclase sus clases.

Swiftui

Acknowlist ahora ofrece una interfaz Swiftui, que admite todas las plataformas principales.

Instanciar una AcknowListSwiftUIView con una ruta al archivo plist , o con una variedad de instancias Acknow , y presente esta vista desde una NavigationView .

Plataformas

Plataforma	Uikit	Swiftui
	iOS 9.0+	iOS 13.0+
	tvos 9.0+	tvos 13.0+
?	Visionos 1.0+	Visionos 1.0+
⌚️	no compatible	Watchos 7.0+
	no compatible	MacOS 10.15+

️ Si instala Acknowlist con Cocoapods o Swift Package Manager, requerirá iOS 13 y TVOS 13. Para admitir versiones anteriores, importe esta biblioteca manualmente e ignore las clases Swiftui. Alternativamente, use vtacknowledgementsViewController en su lugar.

Requisitos

Acknowlist está escrito en Swift 5 y requiere Xcode 12 y superior.

Créditos

Acknowlist fue creado por Vincent Tourraine y mejoró por una creciente lista de contribuyentes.

Licencia

Acknowlist está disponible bajo la licencia MIT. Consulte el archivo LICENSE.txt para obtener más información.