{"id":3046,"url":"https://github.com/vtourraine/VTAcknowledgementsViewController","last_synced_at":"2025-08-03T13:31:42.511Z","repository":{"id":12749816,"uuid":"15422994","full_name":"vtourraine/VTAcknowledgementsViewController","owner":"vtourraine","description":"Acknowledgements screen displaying a list of licenses, for example from CocoaPods dependencies.","archived":false,"fork":false,"pushed_at":"2022-05-25T13:10:20.000Z","size":14786,"stargazers_count":860,"open_issues_count":4,"forks_count":65,"subscribers_count":12,"default_branch":"main","last_synced_at":"2024-04-24T08:23:09.667Z","etag":null,"topics":["cocoapods","ios","objective-c","tvos","uikit"],"latest_commit_sha":null,"homepage":"","language":"Objective-C","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/vtourraine.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2013-12-24T18:02:22.000Z","updated_at":"2024-04-24T08:23:09.667Z","dependencies_parsed_at":"2022-07-21T23:18:04.842Z","dependency_job_id":null,"html_url":"https://github.com/vtourraine/VTAcknowledgementsViewController","commit_stats":null,"previous_names":[],"tags_count":31,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vtourraine%2FVTAcknowledgementsViewController","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vtourraine%2FVTAcknowledgementsViewController/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vtourraine%2FVTAcknowledgementsViewController/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vtourraine%2FVTAcknowledgementsViewController/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/vtourraine","download_url":"https://codeload.github.com/vtourraine/VTAcknowledgementsViewController/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":228548567,"owners_count":17935221,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cocoapods","ios","objective-c","tvos","uikit"],"created_at":"2024-01-05T20:16:29.869Z","updated_at":"2024-12-07T01:30:29.409Z","avatar_url":"https://github.com/vtourraine.png","language":"Objective-C","funding_links":[],"categories":["Utility"],"sub_categories":["Web View","Other free courses"],"readme":"# VTAcknowledgementsViewController\n\nAcknowledgements screen displaying a list of licenses, for example from [CocoaPods](https://cocoapods.org) dependencies.\n\n![Platform iOS](https://img.shields.io/cocoapods/p/VTAcknowledgementsViewController.svg)\n[![Build \u0026 Test](https://github.com/vtourraine/VTAcknowledgementsViewController/actions/workflows/ios.yml/badge.svg)](https://github.com/vtourraine/VTAcknowledgementsViewController/actions/workflows/ios.yml)\n[![CocoaPods compatible](https://img.shields.io/cocoapods/v/VTAcknowledgementsViewController.svg)](https://cocoapods.org/pods/VTAcknowledgementsViewController)\n[![MIT license](http://img.shields.io/badge/license-MIT-blue.svg)](https://github.com/vtourraine/VTAcknowledgementsViewController/raw/master/LICENSE)\n\n_Also available in Swift with [AcknowList](https://github.com/vtourraine/AcknowList)._\n\n![VTAcknowledgementsViewController screenshots](Images/VTAcknowledgementsViewController.png)\n\n## Features\n\n- Automatically load acknowledgments from CocoaPods-generated file\n- Remove unnecessary line breaks from licenses for better text wrapping\n- Optional list header and footer\n- Tappable links in header, footer, and acknowledgment text\n- Storyboard support\n- Dark Mode support\n- Dynamic Type support\n- Localized in 12 languages\n\n## Installation\n\nCocoaPods is the most common solution to install this library.\n\n1. Add `pod 'VTAcknowledgementsViewController'` to your `Podfile`.\n2. Run `pod install`.\n3. Add the `Pods-#target#-acknowledgements.plist` file generated by CocoaPods to your main target: drag and drop the file from the `Pods/Target Support Files/Pods-#target#/` folder in your Xcode project (don’t copy the file, leave `Copy items if needed` unchecked).\n\n## Initialization\n\nThe `VTAcknowledgementsViewController` instance is usually pushed to an existing `UINavigationController`.\n\n``` objc\nVTAcknowledgementsViewController *viewController = [VTAcknowledgementsViewController acknowledgementsViewController];\n[self.navigationController pushViewController:viewController animated:YES];\n```\n\nBy default, the controller will try to guess the name of your `.plist` file, based on the bundle name (`Pods-#bundle-name#-acknowledgements.plist`). If that doesn’t match the file you’re looking for, you can initialize the view controller with a custom file name or path.\n\n``` objc\nviewController = [[VTAcknowledgementsViewController alloc] initWithFileNamed:@\"Pods-MyTarget-acknowledgements\"];\n```\n\n``` objc\nNSString *path = [[NSBundle mainBundle] pathForResource:@\"Pods-MyTarget-acknowledgements\" ofType:@\"plist\"];\nviewController = [[VTAcknowledgementsViewController alloc] initWithPath:path];\n```\n\nIf you want to include licenses that are not part of a `plist` file, you can easily create new `VTAcknowledgement` instances, and use them for the acknowledgements array of the controller.\n\n``` objc\nVTAcknowledgement *customLicense = [[VTAcknowledgement alloc] initWithTitle:@\"...\" text:@\"...\" license:nil];\nviewController = [[VTAcknowledgementsViewController alloc] initWithAcknowledgements:@[customLicense]];\n```\n\n## Customization\n\nThe controller can also display a header and a footer. By default, they are loaded from the generated `plist` file, but you can also directly change the properties values. If these texts contain a link, the view is tappable, and opens a browser with the URL.\n\n``` objc\nviewController.headerText = @\"We love open source software.\";\nviewController.footerText = @\"Powered by CocoaPods.org\";\n```\n\nThe controller title is a localized value for “acknowledgements”. You might want to use this localized value for the button presenting the controller.\n\n``` objc\nNSString *localizedTitle = [VTLocalization localizedTitle]; \n[button setTitle:localizedTitle forState:UIControlStateNormal];\n```\n\nBy default, `VTAcknowledgementsViewController` uses the “grouped” table view style. You can choose a different style:\n\n``` objc\nviewController = [[VTAcknowledgementsViewController alloc] initWithAcknowledgements:@[] style:UITableViewStylePlain];\n```\n\nIf you need to further customize the appearance or behavior of this library, feel free to subclass its classes.\n\n## Apple TV\n\nVTAcknowledgementsViewController is also compatible with tvOS for Apple TV apps.\n\n![VTAcknowledgementsViewController Apple TV screenshots](Images/VTAcknowledgementsViewController-Apple-TV.png)\n\n## Requirements\n\nVTAcknowledgementsViewController supports iOS 9.0 or tvOS 9.0 and above, and requires Xcode 11.0 and above. If you need lower requirements, look for an [older version of this repository](https://github.com/vtourraine/VTAcknowledgementsViewController/releases).\n\n## Credits\n\nVTAcknowledgementsViewController was created by [Vincent Tourraine](https://www.vtourraine.net), and improved by a growing [list of contributors](https://github.com/vtourraine/VTAcknowledgementsViewController/contributors).\n\n## License\n\nVTAcknowledgementsViewController is available under the MIT license. See the [LICENSE.md](./LICENSE.md) file for more info.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvtourraine%2FVTAcknowledgementsViewController","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fvtourraine%2FVTAcknowledgementsViewController","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvtourraine%2FVTAcknowledgementsViewController/lists"}