Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Sunset legacy libraries #7498

Merged
merged 19 commits into from
Mar 27, 2025
Merged
Original file line number Diff line number Diff line change
@@ -1,8 +1,14 @@
---
title: 'Analytics-Android frequently asked questions'
strat: android
custom_ranking:
heading: 0
position: 99999
---

> warning "End-of-Support for Analytics-Android in March 2026"
> End-of-support for the Analytics-Android SDK is scheduled for March 2026. Segment's future development efforts concentrate on the new [Analytics-Kotlin](/docs/connections/sources/catalog/libraries/mobile/kotlin-android/) SDK. If you'd like to upgrade to Analytics-Kotlin, see the [migration guide](/docs/connections/sources/catalog/libraries/mobile/kotlin-android/migration/).

## What is the latest version of the library?

Analytics-Android is published to [Maven Central](http://search.maven.org/#search%7Cgav%7C1%7Cg%3A%22com.segment.analytics.android%22%20AND%20a%3A%22analytics%22) where you can see all published releases.
Original file line number Diff line number Diff line change
@@ -2,5 +2,8 @@
title: Analytics-Android Changelog
repo: analytics-android
strat: android
custom_ranking:
heading: 0
position: 99999
---
{% include content/changelog.html %}
Original file line number Diff line number Diff line change
@@ -2,16 +2,19 @@
title: 'Analytics-Android'
strat: android
repo: analytics-android
support_type: maintenance
support_type: community
id: wXNairW5xX
custom_ranking:
heading: 0
position: 99999
---
Analytics-Android makes it easier for you to send data to any tool without having to learn, test or implement a new API every time.


Analytics-Android only supports any Android device running API 14 (Android 4.0) and higher. This includes Amazon Fire devices.

> info "Analytics-Kotlin"
> The Analytics-Kotlin library is in General Availability. You can use Analytics-Kotlin for [mobile](/docs/connections/sources/catalog/libraries/mobile/kotlin-android/) or [server](/docs/connections/sources/catalog/libraries/server/kotlin) applications. If you'd like to upgrade to Analytics-Kotlin, see the [migration guide](/docs/connections/sources/catalog/libraries/mobile/kotlin-android/migration/). Segment's future development efforts concentrate on the new Analytics-Kotlin SDK, and will only ship security updates for the Analytics-Android SDK.
> warning "End-of-Support for Analytics-Android in March 2026"
> End-of-support for the Analytics-Android SDK is scheduled for March 2026. Segment's future development efforts concentrate on the new [Analytics-Kotlin](/docs/connections/sources/catalog/libraries/mobile/kotlin-android/) SDK. If you'd like to upgrade to Analytics-Kotlin, see the [migration guide](/docs/connections/sources/catalog/libraries/mobile/kotlin-android/migration/).

> success ""
> In addition to the documentation here, you can also [read the Javadocs for all versions of Analytics-Android on Javadoc.io](https://javadoc.io/doc/com.segment.analytics.android/analytics/latest/index.html).
Original file line number Diff line number Diff line change
@@ -1,8 +1,14 @@
---
title: 'Middleware for Analytics-Android'
strat: android
custom_ranking:
heading: 0
position: 99999
---

> warning "End-of-Support for Analytics-Android in March 2026"
> End-of-support for the Analytics-Android SDK is scheduled for March 2026. Segment's future development efforts concentrate on the new [Analytics-Kotlin](/docs/connections/sources/catalog/libraries/mobile/kotlin-android/) SDK. If you'd like to upgrade to Analytics-Kotlin, see the [migration guide](/docs/connections/sources/catalog/libraries/mobile/kotlin-android/migration/).

Middlewares are a powerful mechanism that can augment the events collected by the SDK. A middleware is a simple function that is invoked by the Segment SDK and can be used to monitor, modify, augment or reject events. Source Middleware are available on analytics-android 4.3.0 and later. Destination Middleware are available on analytics-android 4.7.0 and later.

You can register source middleware during construction with the `.useSourceMiddleware` method on the builder. These middleware are invoked for all events, including automatically tracked events, and external event sources like Adjust and Optimizely.
Original file line number Diff line number Diff line change
@@ -2,8 +2,14 @@
title: 'Quickstart: Analytics-Android'
hidden: true
strat: android
custom_ranking:
heading: 0
position: 99999
---

> warning "End-of-Support for Analytics-Android in March 2026"
> End-of-support for the Analytics-Android SDK is scheduled for March 2026. Segment's future development efforts concentrate on the new [Analytics-Kotlin](/docs/connections/sources/catalog/libraries/mobile/kotlin-android/) SDK. If you'd like to upgrade to Analytics-Kotlin, see the [migration guide](/docs/connections/sources/catalog/libraries/mobile/kotlin-android/migration/).

[![Maven Central](https://maven-badges.herokuapp.com/maven-central/com.segment.analytics.android/analytics/badge.svg)](https://maven-badges.herokuapp.com/maven-central/com.segment.analytics.android/analytics)

This tutorial will help you start sending analytics data from your Android app to Segment and any of our destinations, using our Android library. As soon as you're set up you'll be able to turn on any new destinations with the flip of a switch!
Original file line number Diff line number Diff line change
@@ -1,8 +1,14 @@
---
title: 'Troubleshooting Analytics-Android'
strat: android
custom_ranking:
heading: 0
position: 99999
---

> warning "End-of-Support for Analytics-Android in March 2026"
> End-of-support for the Analytics-Android SDK is scheduled for March 2026. Segment's future development efforts concentrate on the new [Analytics-Kotlin](/docs/connections/sources/catalog/libraries/mobile/kotlin-android/) SDK. If you'd like to upgrade to Analytics-Kotlin, see the [migration guide](/docs/connections/sources/catalog/libraries/mobile/kotlin-android/migration/).

## No events in my debugger

1. Check that you followed all of the [Getting Started](/docs/connections/sources/catalog/libraries/mobile/android/#getting-started) steps correctly
Original file line number Diff line number Diff line change
@@ -2,8 +2,14 @@
title: 'Analytics-Android Wear'
strat: android
hidden: true
custom_ranking:
heading: 0
position: 99999
---

> warning "End-of-Support for Analytics-Android in March 2026"
> End-of-support for the Analytics-Android SDK is scheduled for March 2026. Segment's future development efforts concentrate on the new [Analytics-Kotlin](/docs/connections/sources/catalog/libraries/mobile/kotlin-android/) SDK. If you'd like to upgrade to Analytics-Kotlin, see the [migration guide](/docs/connections/sources/catalog/libraries/mobile/kotlin-android/migration/).

Analytics-Android Wear makes it simple to send your data to any tool without having to learn, test, or implement a new API every time.

All of Segment's client libraries are open-source, so you can [view Analytics-Android on GitHub](https://github.com/segmentio/analytics-android), or check out our [browser and server-side libraries](/docs/connections/sources/catalog/) too.
Original file line number Diff line number Diff line change
@@ -2,5 +2,8 @@
title: Analytics-iOS Changelog
repo: analytics-ios
strat: ios
custom_ranking:
heading: 0
position: 99999
---
{% include content/changelog.html %}
11 changes: 7 additions & 4 deletions src/connections/sources/catalog/libraries/mobile/ios/index.md
Original file line number Diff line number Diff line change
@@ -2,21 +2,24 @@
title: Analytics-iOS
strat: ios
repo: analytics-ios
support_type: maintenance
support_type: community
id: UBrsG9RVzw
custom_ranking:
heading: 0
position: 99999
---
With Analytics-iOS, you can send your data to analytics or marketing tool, without needing to learn, test, or implement a new API with each update or addition.
<br />
<br />
<br />

> warning "End-of-Support for Analytics-iOS in March 2026"
> End-of-support for the Analytics-iOS SDK is scheduled for March 2026. Segment's future development efforts concentrate on the new [Analytics-Swift](/docs/connections/sources/catalog/libraries/mobile/swift/){:target="_blank”} SDK. If you'd like to migrate to Analytics-Swift, see the [migration guide](/docs/connections/sources/catalog/libraries/mobile/swift/migration/){:target="_blank”}.

> info "Watchkit extensions currently unsupported"
> Segment does not currently support tracking of watchkit extensions for the Apple Watch. [Email Segment](https://segment.com/requests/integrations/){:target="_blank”}. if you're interested in a Watchkit SDK. For now Segment recommends tracking watch interactions using the iPhone app code.


> info "Analytics-Swift"
> The [Analytics-Swift](/docs/connections/sources/catalog/libraries/mobile/swift/){:target="_blank”}. library is in General Availability. If you'd like to migrate to Analytics-Swift, see the [migration guide](/docs/connections/sources/catalog/libraries/mobile/swift/migration/){:target="_blank”}.. Segment's future development efforts concentrate on the new Analytics-Kotlin SDK, and will only ship security updates for the Analytics-Android SDK.

## Analytics-iOS and Unique Identifiers

One of the most important parts of any analytics platform is the ability to consistently and accurately identify users. To do this, the platform must assign and persist some form of identification on the device, so you can analyze user actions effectively. This is especially important for funnel conversion analysis and retention analysis.
Original file line number Diff line number Diff line change
@@ -1,8 +1,14 @@
---
title: Analytics-iOS Frequently asked questions
strat: ios
custom_ranking:
heading: 0
position: 99999
---

> warning "End-of-Support for Analytics-iOS in March 2026"
> End-of-support for the Analytics-iOS SDK is scheduled for March 2026. Segment's future development efforts concentrate on the new [Analytics-Swift](/docs/connections/sources/catalog/libraries/mobile/swift/){:target="_blank”} SDK. If you'd like to migrate to Analytics-Swift, see the [migration guide](/docs/connections/sources/catalog/libraries/mobile/swift/migration/){:target="_blank”}.

## How big is the Segment SDK?

The core Segment SDK is extremely lightweight. It weighs in at about 212KB.
Original file line number Diff line number Diff line change
@@ -1,8 +1,14 @@
---
title: iOS 14 Guide
strat: ios
custom_ranking:
heading: 0
position: 99999
---

> warning "End-of-Support for Analytics-iOS in March 2026"
> End-of-support for the Analytics-iOS SDK is scheduled for March 2026. Segment's future development efforts concentrate on the new [Analytics-Swift](/docs/connections/sources/catalog/libraries/mobile/swift/){:target="_blank”} SDK. If you'd like to migrate to Analytics-Swift, see the [migration guide](/docs/connections/sources/catalog/libraries/mobile/swift/migration/){:target="_blank”}.

> warning ""
> You should update your `analytics-ios` and device-mode destinations to adapt to iOS 14 changes explained in this guide. For information about iOS 14.5, see [What's new in iOS 14.5](#whats-new-with-ios-145) below.

Original file line number Diff line number Diff line change
@@ -1,8 +1,14 @@
---
title: Middleware for iOS
strat: ios
custom_ranking:
heading: 0
position: 99999
---

> warning "End-of-Support for Analytics-iOS in March 2026"
> End-of-support (EoS) for the Analytics-iOS SDK is scheduled for March 2026. Segment's future development efforts concentrate on the new [Analytics-Swift](/docs/connections/sources/catalog/libraries/mobile/swift/){:target="_blank”} SDK. If you'd like to migrate to Analytics-Swift, see the [migration guide](/docs/connections/sources/catalog/libraries/mobile/swift/migration/){:target="_blank”}.

Middlewares are simple functions invoked by the Segment libraries, which give you a way to add information to the events you collect using the Segment SDKs. They can be used to monitor, modify, or reject events. Source Middlewares are available on `analytics-ios` 3.6.0 and later.

You can access the middleware API in both Objective-C and Swift.
Original file line number Diff line number Diff line change
@@ -2,8 +2,14 @@
title: 'Quickstart: iOS'
hidden: true
strat: ios
custom_ranking:
heading: 0
position: 99999
---

> warning "End-of-Support for Analytics-iOS in March 2026"
> End-of-support for the Analytics-iOS SDK is scheduled for March 2026. Segment's future development efforts concentrate on the new [Analytics-Swift](/docs/connections/sources/catalog/libraries/mobile/swift/){:target="_blank”} SDK. If you'd like to migrate to Analytics-Swift, see the [migration guide](/docs/connections/sources/catalog/libraries/mobile/swift/migration/){:target="_blank”}.

This tutorial gets you started sending data from your iOS app to Segment. When you're done you can turn on [any of Segment's destinations](/docs/connections/destinations/) with the flip of a switch! No more waiting for App Store approval.

If you want to dive deeper at any point, check out the [iOS Library Reference](/docs/connections/sources/catalog/libraries/mobile/ios/).
Original file line number Diff line number Diff line change
@@ -1,8 +1,14 @@
---
title: Troubleshooting Analytics-iOS
strat: ios
custom_ranking:
heading: 0
position: 99999
---

> warning "End-of-Support for Analytics-iOS in March 2026"
> End-of-support for the Analytics-iOS SDK is scheduled for March 2026. Segment's future development efforts concentrate on the new [Analytics-Swift](/docs/connections/sources/catalog/libraries/mobile/swift/){:target="_blank”} SDK. If you'd like to migrate to Analytics-Swift, see the [migration guide](/docs/connections/sources/catalog/libraries/mobile/swift/migration/){:target="_blank”}.

## Target has transitive dependencies that include static binaries

This was due to an old [CocoaPods limitation](https://github.com/CocoaPods/CocoaPods/issues/2926).
Original file line number Diff line number Diff line change
@@ -88,7 +88,7 @@ These are the options you can apply to configure the client:
| `storePersistor` | undefined | A custom persistor for the store that `analytics-react-native` uses. Must match [`Persistor`](https://github.com/segmentio/analytics-react-native/blob/master/packages/sovran/src/persistor/persistor.ts#L1-L18) interface exported from [sovran-react-native](https://github.com/segmentio/analytics-react-native/blob/master/packages/sovran). |
| `proxy` | undefined | `proxy` is a batch url to post to instead of 'https://api.segment.io/v1/b'. |
| `errorHandler` | undefined | Create custom actions when errors happen, see [Handling errors](#handling-errors) |

| `useSegmentEndpoints` | false | Set to `true` to automatically append the Segment endpoints when using `proxy` or `cdnProxy` to send or fetch settings. Otherwise, `proxy` or `cdnProxy` will be used as is. |

## Adding Plugins to the Client

Loading
Oops, something went wrong.
Loading
Oops, something went wrong.