AcknowList

Acknownist

Tela Agradecimentos exibindo uma lista de licenças, por exemplo, de Cocoapods e Swift Package Manager Dependências.

Também disponível no Objective-C com o VTackNowledGementsViewController.

Características

• Carregar reconhecimentos de arquivos gerados por Cocoapods ( Pods-###-acknowledgements.plist )
• Carregar reconhecimentos dos arquivos do Swift Package Manager ( Package.resolved )
• Buscar licenças SPM ausentes da API do GitHub
• Remova quebras de linha desnecessárias das licenças para melhor embrulho de texto
• Cabeçalho e rodapé da lista opcional
• Links tappable no cabeçalho, rodapé e texto de reconhecimento
• Suporte de storyboard
• Suporte ao modo escuro
• Suporte ao tipo dinâmico
• Localizado em 13 idiomas
• Interfaces de Uikit e Swiftui

Instalação

Cocoapods

1. Adicione pod 'AcknowList' ao seu Podfile .
2. Execute pod install .
3. Adicione os Pods-#target#-acknowledgements.plist ARQUIVO GERERADO POR COCAPODS À SEU TARVEIRO PRINCIPAL: arraste e solte o arquivo dos Pods/Target Support Files/Pods-#target#/ Pasta para o seu projeto Xcode (não copie o arquivo, deixe Copy items if needed ).

Gerente de pacotes Swift

O ACKnowlist pode ser instalado com o Swift Package Manager (requer Xcode 12 para recursos localizados).

1. Clique no File → Add Packages… .
2. Digite https://github.com/vtourraine/AcknowList .
3. Selecione a versão que você gostaria de usar.
4. Adicione o arquivo Package.resolved gerado pelo Xcode ao seu destino principal. Arraste e solte o arquivo da pasta para o seu projeto Xcode (não copie o arquivo, deixe Copy items if needed desmarcado).
   • Para projetos Xcode únicos, o arquivo está em [appName].xcodeproj/project.xcworkspace/xcshareddata/swiftpm/
   • Para os espaços de trabalho do Xcode (por exemplo com Cocoapods), o arquivo está em [appName].xcworkspace/xcshareddata/swiftpm/

Inicialização

A instância AcknowListViewController é geralmente empurrada para um UINavigationController existente.

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

Por padrão, o controlador tentará carregar reconhecimentos de um arquivo Plist Cocoapods (adivinhando sua localização com base no nome do pacote), bem como em um arquivo Package.resolved .

Você também pode inicializar o controlador de exibição com um nome de arquivo ou 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 )

Se você deseja incluir licenças que não fazem parte de um arquivo .plist ou .resolved , você pode criar novas instâncias Acknow e usá -las para a matriz de agradecimentos do controlador.

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

Personalização

O controlador também pode exibir um cabeçalho e um rodapé. Por padrão, eles são carregados do arquivo plist gerado, mas você também pode alterar diretamente os valores das propriedades.

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

O título do controlador é um valor localizado para "Agradecimentos". Você pode usar esse valor localizado para o botão que apresenta o controlador.

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

Por padrão, AcknowListViewController usa o estilo de exibição da tabela "agrupado". Você pode escolher um estilo diferente:

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

Se você precisar personalizar ainda mais a aparência ou o comportamento desta biblioteca, sinta -se à vontade para subclasse suas classes.

Swiftui

O ACKnowlist agora oferece uma interface Swiftui, que suporta todas as principais plataformas.

Instanciar um AcknowListSwiftUIView com um caminho para o arquivo plist , ou com uma matriz de reconhecimento Acknow , e apresente essa visualização de uma NavigationView .

Plataformas

Plataforma	Uikit	Swiftui
	iOS 9.0+	iOS 13.0+
	TvOS 9.0+	TvOS 13.0+
?	Visionos 1.0+	Visionos 1.0+
⌚️	não suportado	WatchOS 7.0+
	não suportado	MacOS 10.15+

️ Se você instalar o AckNowlist com o Cocoapods ou o Swift Package Manager, será necessário o iOS 13 e o TvOS 13. Para oferecer suporte a versões anteriores, importe esta biblioteca manualmente e ignore as classes Swiftui. Como alternativa, use o vtackNowledGementsViewController.

Requisitos

O AckNowlist está escrito no Swift 5 e requer Xcode 12 e acima.

Créditos

O AckNowlist foi criado por Vincent Tourraine e melhorado por uma lista crescente de colaboradores.

Licença

O ACKnowlist está disponível sob a licença do MIT. Consulte o arquivo LICENSE.txt para obter mais informações.