https://github.com/amplitude/amplitude-ios

Native iOS/tvOS/macOS SDK
https://github.com/amplitude/amplitude-ios

amplitude amplitude-ios analytics best carthage cocoapods hacktoberfest ios mobile mobile-app objective-c product sdk swift-package-manager tvos

Last synced: about 1 month ago
JSON representation

Native iOS/tvOS/macOS SDK

• Host: GitHub
• URL: https://github.com/amplitude/amplitude-ios
• Owner: amplitude
• License: mit
• Created: 2012-09-06T13:24:14.000Z (over 12 years ago)
• Default Branch: main
• Last Pushed: 2025-02-26T21:45:20.000Z (3 months ago)
• Last Synced: 2025-04-06T14:08:16.753Z (about 1 month ago)
• Topics: amplitude, amplitude-ios, analytics, best, carthage, cocoapods, hacktoberfest, ios, mobile, mobile-app, objective-c, product, sdk, swift-package-manager, tvos
• Language: Objective-C
• Homepage:
• Size: 6.17 MB
• Stars: 308
• Watchers: 106
• Forks: 194
• Open Issues: 47
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • Contributing: CONTRIBUTING.md
  • License: LICENSE

Awesome Lists containing this project

README

        


  

    

  

  




[![Legacy SDK](https://img.shields.io/badge/state-legacy-yellow)](https://github.com/amplitude/Amplitude-Swift)

[![CocoaPods](https://img.shields.io/cocoapods/v/Amplitude)](https://cocoapods.org/pods/Amplitude)

[![Carthage compatible](https://img.shields.io/badge/Carthage-compatible-4BC51D.svg?style=flat)](https://github.com/Carthage/Carthage)

[![All Contributors](https://img.shields.io/badge/all_contributors-8-orange.svg?style=flat)](#contributors-)

# Announcement 📣

Amplitude is introducing a new [iOS Swift SDK](https://github.com/amplitude/Amplitude-Swift). This new SDK provides improved developer experience, helps users instrument data more seamlessly and provide more control over data being instrumented using custom plugins.

To learn more about the new SDK, here are some useful links:

* GitHub: https://github.com/amplitude/Amplitude-Swift

* Documentation: https://www.docs.developers.amplitude.com/data/sdks/ios-swift/

* Migration Guide: https://www.docs.developers.amplitude.com/data/sdks/ios-swift/migration/

# Official Amplitude iOS SDK

iOS/tvOS/macOS SDK for tracking events and revenue to [Amplitude](https://www.amplitude.com).

## Amplitude and Ampli SDK

[Ampli SDK](https://developers.data.amplitude.com/ampli-sdk-overview/) is autogenerated library based on your pre-defined [tracking plan](https://developers.data.amplitude.com/what-is-a-tracking-plan). The Ampli SDK, is a lightweight wrapper over the Amplitude SDK that provides type-safety, supports linting, and enables features like input validation. The code replicates the spec in the Tracking Plan and enforces its rules and requirements. This repository is about **Amplitude SDK**. To learn more about Ampli SDK, please refer to the [Ampli iOS](https://developers.data.amplitude.com/ios-ampli) and [examples](https://github.com/amplitude/ampli-examples).

## Installation and Quick Start

* For using the SDK, please visit our :100:[Developer Center](https://developers.amplitude.com/docs/ios).

* For developing the SDK, please visit our [CONTRIBUTING.md](https://github.com/amplitude/Amplitude-iOS/blob/main/CONTRIBUTING.md).

## Demo Applications

* A [demo application](https://github.com/amplitude/iOS-Demo) showing the integration of our SDK using Cocoapods.

* A [demo application](https://github.com/amplitude/iOS-Demo-Carthage) showing the integration of our SDK using Carthage.

* A [demo application](https://github.com/amplitude/Segment-iOS-Demo) showing the integration of our SDK via [Segment's](https://segment.com/) iOS SDK.

* A [demo application](https://github.com/amplitude/iOS-Extension-Demo) showing an integration in an iOS extension.

* A [demo application](https://github.com/amplitude/GTM-iOS-Demo) demonstrating a potential integration with Google Tag Manager.

## Developing

Prerequisites

 * [Cocoapods](https://cocoapods.org/)

 * [Carthage](https://github.com/Carthage/Carthage)

1. Install Dependencies via Carthage

    ```

    carthage update --use-xcframeworks

    ```

2. Install Test Dependencies via CocoaPods

    ```

    pod install

    ```

## Contributors

  

    
Hao Liu
📖 💻

    
Daniel Jih
💻 📖

    
Curtis Liu
💻 📖 🤔

    
Spenser Skates
💻 📖 🤔

    
Krishna Rajendran
💻

    
samantha puth
💻

    
Mayur
💻

  

  

    
Rob Phillips
💻

  

## Changelog

Click [here](https://github.com/amplitude/Amplitude-iOS/blob/main/CHANGELOG.md) to view the iOS SDK Changelog.

## Need Help?

If you have any problems or issues over our SDK, please refer to the [Developer Center](https://developers.amplitude.com/docs/ios) for help. If you don't find a solution there, then feel free to create a GitHub issue or submit a request on [Amplitude Help](https://help.amplitude.com/hc/en-us/requests/new).