Acknowledgements screen displaying a list of licences, for example from CocoaPods dependencies.
Also available in Swift with AcknowList.
- Automatically load acknowledgments from CocoaPods-generated file
- Remove unnecessary line breaks from licences for better text wrapping
- Optional list header and footer
- Tappable links in header, footer, and acknowledgment text
- Storyboard support
- Dark Mode support
- Dynamic Type support, with automatic font adjustment
- Localized in 12 languages
How to Install
CocoaPods is the most common solution to install this library.
pod 'VTAcknowledgementsViewController'to your
- Add the
Pods-#target#-acknowledgements.plistfile generated by CocoaPods in
Pods/Target Support Files/Pods-#target#/to your main target (drag and drop the file in your Xcode project). Don’t copy the file, leave
Copy items if neededunchecked.
VTAcknowledgementsViewController instance is usually pushed to an existing
VTAcknowledgementsViewController *viewController = [VTAcknowledgementsViewController acknowledgementsViewController]; [self.navigationController pushViewController:viewController animated:YES];
By 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.
viewController = [[VTAcknowledgementsViewController alloc] initWithFileNamed:@"Pods-MyTarget-acknowledgements"];
NSString *path = [[NSBundle mainBundle] pathForResource:@"Pods-MyTarget-acknowledgements" ofType:@"plist"]; viewController = [[VTAcknowledgementsViewController alloc] initWithPath:path];
If you need to include licenses that are not part of the generated
plist file, or if you don’t want to use the generated
plist at all, you can easily create new
VTAcknowledgement instances, and set them as the acknowledgements array of the controller.
VTAcknowledgement *customLicense = [[VTAcknowledgement alloc] initWithTitle:@"..." text:@"..." license:nil]; viewController.acknowledgements = @[customLicense];
The 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.
viewController.headerText = @"We love open source software."; viewController.footerText = @"Powered by CocoaPods.org";
The controller title is a localized value for “acknowledgements”. You might want to use this localized value for the button presenting the controller.
NSString *localizedTitle = [VTAcknowledgementsViewController localizedTitle]; [button setTitle:localizedTitle forState:UIControlStateNormal];
If you need to further customize the appearance or behavior of this pod, feel free to subclass its classes.
VTAcknowledgementsViewController is also compatible with tvOS for Apple TV apps.
VTAcknowledgementsViewController supports iOS 8.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.
VTAcknowledgementsViewController is available under the MIT license. See the LICENSE.md file for more info.