Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/twitter-archive/twitter-kit-ios

Twitter Kit is a native SDK to include Twitter content inside mobile apps.
https://github.com/twitter-archive/twitter-kit-ios

Last synced: 6 days ago
JSON representation

Twitter Kit is a native SDK to include Twitter content inside mobile apps.

Host: GitHub
URL: https://github.com/twitter-archive/twitter-kit-ios
Owner: twitter-archive
License: apache-2.0
Archived: true
Created: 2017-08-22T19:16:55.000Z (over 7 years ago)
Default Branch: master
Last Pushed: 2019-04-26T03:28:36.000Z (over 5 years ago)
Last Synced: 2024-11-24T09:34:52.596Z (18 days ago)
Language: Objective-C
Homepage:
Size: 32.2 MB
Stars: 691
Watchers: 44
Forks: 447
Open Issues: 45
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE

Awesome Lists containing this project

awesome-ios - twitter-kit-ios - Twitter Kit is a native SDK to include Twitter content inside mobile apps. (SDK / Official)
awesome-ios-star - twitter-kit-ios - Twitter Kit is a native SDK to include Twitter content inside mobile apps. (SDK / Official)

README

**Twitter will be discontinuing support for Twitter Kit on October 31, 2018. [Read the blog post here](https://blog.twitter.com/developer/en_us/topics/tools/2018/discontinuing-support-for-twitter-kit-sdk.html).**

# Twitter Kit for iOS

## Background

Twitter Kit is a native SDK to include Twitter content in mobile apps. Twitter Kit is designed to make interacting with Twitter seamless and efficient.

Using Twitter Kit from source in production applications is not officially supported. Please utilize the official binaries released via [CocoaPods](https://cocoapods.org/pods/TwitterKit) or [Carthage](https://github.com/Carthage/Carthage).

## Twitter Kit Features

* Display Tweets and timelines
* Native views to display Tweets in alignment with Twitter's display guidelines.
* Timeline adapters for displaying collections, lists, and profile timelines from the Twitter API
* Search result timelines using the Search API, with additional client-side filter capability
* Compose Tweets
* Share Tweets with text, URLs, photos and video.
* Automatically handles API access and login for quick sharing.
* Monetize with MoPub integration
* Easy integration of MoPub's display ads tools with Twitter content.
* Log in with Twitter
* Authorize users, using the Twitter accounts already on their phone.
* Support for requesting email address
* Access the Twitter API
* API client for all interactions with the Twitter API.

## Components of Twitter Kit iOS

* TwitterCore
* Network calls are handled
* TwitterKit
* Tweet display
* TwitterShareExtensionUI
* Tweet composer

## Installation

### Get started

* Generate your Twitter API keys through the [Twitter developer apps dashboard](https://apps.twitter.com/).
* Install Twitter Kit using instructions below.
* For extensive documentation, please see the official [documentation](https://github.com/twitter/twitter-kit-ios/wiki).

### Install using Cocoapods

To add Twitter Kit to your app, simply add `TwitterKit` to your Podfile.

```ruby
target 'MyApp' do
use_frameworks!
pod 'TwitterKit'
end
```

### Install using Carthage

To install Twitter Kit for iOS using Carthage, add the following lines to your Cartfile. For more information about how to set up Carthage and your Cartfile, see [here](https://github.com/Carthage/Carthage).

```swift
binary "https://ton.twimg.com/syndication/twitterkit/ios/TwitterKit.json"
binary "https://ton.twimg.com/syndication/twitterkit/ios/TwitterCore.json"
```

After running `carthage update`, add `TwitterKit.framework` and `TwitterShareExtensionUI.framework` to the `Linked Frameworks and Binaries` section under General of your App target. In addition to that, make sure that when you are adding the copy-frameworks run script for Carthage that you add the following input paths:

```swift
$(SRCROOT)/Carthage/Build/iOS/TwitterCore.framework
$(SRCROOT)/Carthage/Build/iOS/TwitterKit.framework
$(SRCROOT)/Carthage/Build/iOS/TwitterShareExtensionUI.framework
```

Make sure that the run script phase is after your Link Binaries with Libraries phase to prevent issues with properly archiving your iOS application.

### Preview Twitter Kit Features in the Demo App

Twitter Kit includes a demonstration app allowing you to preview features, and verify functionality. Create Twitter API keys as above, and then:

* To check out a demo app with features already built in, rename `DemoApp/Config.xcconfig.sample` to `DemoApp/Config.xcconfig` and populate the consumer key and secret.
* Run `DemoApp.xcworkspace` on Xcode to verify build.

## Code of conduct

This, and all github.com/twitter projects, are under the [Twitter Open Source Code of Conduct](https://github.com/twitter/code-of-conduct/blob/master/code-of-conduct.md). Additionally, see the [Typelevel Code of Conduct](http://typelevel.org/conduct) for specific examples of harassing behavior that are not tolerated.

## Contribution

The master branch of this repository contains the latest stable release of Twitter Kit.

Twitter Kit can be used as a dependency for substantial other work, and we welcome fixes and enhancements to the core libraries as well. See [CONTRIBUTING.md](https://github.com/twitter/twitter-kit-ios/blob/master/CONTRIBUTING.md) for more details about how to contribute.

## Contact

For usage questions post on [Twitter Community](https://twittercommunity.com/tags/c/publisher/twitter/ios).
Please report any bugs as [issues](https://github.com/twitter/twitter-kit-ios/issues).
Follow [@TwitterDev](http://twitter.com/twitterdev) on Twitter for updates.

## License