{"id":13685096,"url":"https://github.com/iGriever/TWSReleaseNotesView","last_synced_at":"2025-05-01T01:30:34.369Z","repository":{"id":9914696,"uuid":"11924395","full_name":"iGriever/TWSReleaseNotesView","owner":"iGriever","description":"A simple way to show in-app release notes in your iOS applications.","archived":false,"fork":false,"pushed_at":"2016-01-30T02:03:27.000Z","size":5732,"stargazers_count":437,"open_issues_count":12,"forks_count":68,"subscribers_count":22,"default_branch":"master","last_synced_at":"2024-11-09T17:49:02.613Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"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/iGriever.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2013-08-06T13:15:51.000Z","updated_at":"2024-01-19T12:09:37.000Z","dependencies_parsed_at":"2022-09-16T21:01:57.367Z","dependency_job_id":null,"html_url":"https://github.com/iGriever/TWSReleaseNotesView","commit_stats":null,"previous_names":[],"tags_count":4,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/iGriever%2FTWSReleaseNotesView","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/iGriever%2FTWSReleaseNotesView/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/iGriever%2FTWSReleaseNotesView/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/iGriever%2FTWSReleaseNotesView/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/iGriever","download_url":"https://codeload.github.com/iGriever/TWSReleaseNotesView/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":224230727,"owners_count":17277373,"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":[],"created_at":"2024-08-02T14:00:43.783Z","updated_at":"2024-11-12T06:31:14.788Z","avatar_url":"https://github.com/iGriever.png","language":"Objective-C","readme":"TWSReleaseNotesView\n===================\n\nAmong other crazy features, iOS 7 enables users to have automatic updates for their apps, wiping away the infamous App Store badge. This is really convenient both for users and developers, but it comes with a couple of downsides:\n\n* users are not aware about the changes introduced in the latest update, unless they explicitly open the App Store page to check the release notes;\n* developers who spend their time working on well-written release notes lose their chance to inform and communicate with their users.\n\n## So what?\nTWSReleaseNotesView is a simple way to address those issues. It comes with a straightforward API which enables developers to show in-app release notes with a fully customizable popup view.\n\n\n## How to get started\n### CocoaPods\n1. Just add the following line to your Podfile: `pod 'TWSReleaseNotesView', '~\u003e 1.2.0'`\n2. You're good to go!\n\n### Manual installation\n1. Download the TWSReleaseNotesView folder and add it to your project.\n2. In addition to the default `UIKit`, `CoreGraphics` and `Foundation`, there's a dependency from the `Accelerate` and the `Quartzcore` frameworks. If any of them is missing in your Frameworks list, follow these steps in order to add them:\n  * Go to the \"Build Phases\" tab for your project target.\n  * Click the `+` button in the collapsible \"Link Binary With Libraries\" section.\n  * Add the missing frameworks.\n3. That's it!\n\n# Example usage\n\n## Version check and local release notes view setup\n```objective-c\n    // Check for first app launch and app update\n    if (![TWSReleaseNotesView isAppOnFirstLaunch] \u0026\u0026 [TWSReleaseNotesView isAppVersionUpdated])\n    {\n        // Create the release notes view\n        NSString *currentAppVersion = [[NSBundle mainBundle] infoDictionary][@\"CFBundleVersion\"];\n        TWSReleaseNotesView *releaseNotesView = [TWSReleaseNotesView viewWithReleaseNotesTitle:[NSString stringWithFormat:@\"What's new in version %@:\", currentAppVersion] text:@\"• Great new feature\\n• Annoying bug wiped away\\n• Optimizations and other great stuff!\\n• Additional performance and stability improvements\" closeButtonTitle:@\"Close\"];\n        \n        // Show the release notes view\n        [releaseNotesView showInView:self.view];\n    }\n```\n\n## Version check and remote release notes view setup\n```objective-c\n    // Check for app update\n    if ([TWSReleaseNotesView isAppVersionUpdated])\n    {\n        // Setup a remote release notes view\n        NSString *currentAppVersion = [[NSBundle mainBundle] infoDictionary][@\"CFBundleVersion\"];\n        [TWSReleaseNotesView setupViewWithAppIdentifier:@\"XXXXXXXXX\" releaseNotesTitle:[NSString stringWithFormat:@\"What's new in version %@:\", currentAppVersion] closeButtonTitle:@\"Close\" completionBlock:^(TWSReleaseNotesView *releaseNotesView, NSString *releaseNotesText, NSError *error){\n            if (error)\n            {\n                // Handle errors\n                NSLog(@\"An error occurred: %@\", [error localizedDescription]);\n            }\n            else\n            {                \n                // Create and show release notes view\n                [releaseNotesView showInView:self.view];\n            }\n        }];\n    }\n```\n\n## Sample project\nThe **TWSReleaseNotesViewSample** sample project shows how to deal with the two use cases described above.\n\n![Sample project menu](TutorialImages/sampleProject01.png)    ![Sample project view](TutorialImages/sampleProject02.png)\n\n## Features\n* First app launch check.\n* Version check in order to choose whether showing the release notes view or not.\n* Local release notes view with custom appearance and text information.\n* Remote release notes view using the application's Apple ID, in order to retrieve the last release notes directly from App Store, using the iTunes Search API.\n\n## Documentation\nThe code is fully commented using a [Javadoc](http://en.wikipedia.org/wiki/Javadoc)-like syntax, in order to use [appledoc](https://github.com/tomaz/appledoc) for the documentation generation. Check the **TWReleaseNotesView Docs** folder for the complete documentation, in both html and .docset format. The .docset file can be copied in the `~/Library/Developer/Shared/Documentation/DocSets` folder, in order to be able to read the documentation in Xcode. If you decide to do so, please, remember to close Xcode before copying the .docset file in the proper folder, then re-open it.\n\n## Credits\nTWSReleaseNotesView was developed by **Tapwings**: Matteo Lallone (iOS developer - [@iGriever](https://twitter.com/iGriever)) and Gianluca Divisi (UI/UX designer - [@gianlucadivisi](https://twitter.com/gianlucadivisi)). Follow us on Twitter ([@tapwings](https://twitter.com/tapwings)) to receive updates on our work.\n\n## License\nThe MIT License (MIT)\n\nCopyright (c) 2013 Matteo Lallone\n\nPermission is hereby granted, free of charge, to any person obtaining a copy of\nthis software and associated documentation files (the \"Software\"), to deal in\nthe Software without restriction, including without limitation the rights to\nuse, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of\nthe Software, and to permit persons to whom the Software is furnished to do so,\nsubject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in all\ncopies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\nIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS\nFOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR\nCOPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER\nIN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN\nCONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.\n","funding_links":[],"categories":["Objective-C","etc"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FiGriever%2FTWSReleaseNotesView","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FiGriever%2FTWSReleaseNotesView","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FiGriever%2FTWSReleaseNotesView/lists"}