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

Open
wants to merge 12 commits into
base: develop
Choose a base branch
from
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 2 additions & 2 deletions src/_data/catalog/sources.yml
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@ items:
display_name: .NET
isCloudEventSource: false
slug: net
url: connections/sources/catalog/libraries/server/net
url: connections/sources/catalog/libraries/server/csharp
hidden: false
regions:
- us
Expand Down Expand Up @@ -2579,7 +2579,7 @@ items:
display_name: Xamarin
isCloudEventSource: false
slug: xamarin
url: connections/sources/catalog/libraries/mobile/xamarin
url: connections/sources/catalog/libraries/server/csharp
hidden: false
regions:
- us
Expand Down
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 Announcement for Analytics-Android - March 2026"
> The end-of-support (EoS) 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.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Up @@ -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 Announcement for Analytics-Android - March 2026"
> The end-of-support (EoS) 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).
Expand Down
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 Announcement for Analytics-Android - March 2026"
> The end-of-support (EoS) 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.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -2,8 +2,14 @@
title: 'Quickstart: Analytics-Android'
hidden: true
strat: android
custom_ranking:
heading: 0
position: 99999
---

> warning "End-of-Support Announcement for Analytics-Android - March 2026"
> The end-of-support (EoS) 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!
Expand Down
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 Announcement for Analytics-Android - March 2026"
> The end-of-support (EoS) 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
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -2,8 +2,14 @@
title: 'Analytics-Android Wear'
strat: android
hidden: true
custom_ranking:
heading: 0
position: 99999
---

> warning "End-of-Support Announcement for Analytics-Android - March 2026"
> The end-of-support (EoS) 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.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Up @@ -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 Announcement for Analytics-iOS - March 2026"
> The 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”}.

> 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.
Expand Down
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 Announcement for Analytics-iOS - March 2026"
> The 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”}.

## How big is the Segment SDK?

The core Segment SDK is extremely lightweight. It weighs in at about 212KB.
Expand Down
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 Announcement for Analytics-iOS - March 2026"
> The 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”}.

> 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.

Expand Down
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 Announcement for Analytics-iOS - March 2026"
> The 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.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -2,8 +2,14 @@
title: 'Quickstart: iOS'
hidden: true
strat: ios
custom_ranking:
heading: 0
position: 99999
---

> warning "End-of-Support Announcement for Analytics-iOS - March 2026"
> The 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”}.

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/).
Expand Down
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 Announcement for Analytics-iOS - March 2026"
> The 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”}.

## Target has transitive dependencies that include static binaries

This was due to an old [CocoaPods limitation](https://github.com/CocoaPods/CocoaPods/issues/2926).
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -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

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,14 @@ sourceTitle: 'Xamarin'
sourceCategory: 'Mobile'
id: wcssVcPJrc
support_type: community
custom_ranking:
heading: 0
position: 99999
---

> warning "End-of-Support Announcement for Analytics.Xamarin - March 2026"
> The end-of-support (EoS) for the Analytics.Xamarin SDK is scheduled for March 2026. Segment's future development efforts concentrate on the new [Analytics-CSharp](/docs/connections/sources/catalog/libraries/server/csharp/) SDK. If you'd like to migrate to Analytics-CSharp, see the [migration guide](/docs/connections/sources/catalog/libraries/server/csharp/migration-guide/).

Segment's [Xamarin](http://xamarin.com/) Portable Class Library ([PCL](http://developer.xamarin.com/guides/cross-platform/application_fundamentals/pcl/)) is the best way to integrate analytics into your Xamarin application. It lets you record analytics data from your C#, F#, and .NET code, and supports `PCL Profile 4.0 - Profile136`, which targets the following platforms:

- .NET Framework 4 or later
Expand All @@ -20,9 +27,6 @@ The library issues requests that hit our servers, and then we route your data to

**Note:** Since Xamarin requires Segment's library to be portable to different builds, Segment can only enable server-side destinations, as opposed to bundling select native SDKs like we do for iOS and Android. Look for the "Server" icon when selecting destinations. For tools for which we offer both bundled and server-side destinations, like Mixpanel, Amplitude, and Google Analytics, Segment's Xamarin library will only be able to use their server-side functionality.

> info "Analytics-CSharp (C#)"
> With [Analytics-CSharp](/docs/connections/sources/catalog/libraries/server/csharp/), you can add Segment analytics to your C# based app which includes Xamarin. If you'd like to migrate to use Analytics-CSharp, see the [Analytics-CSharp migration guide](/docs/connections/sources/catalog/libraries/server/csharp/migration-guide/).

## Getting Started

Clone `Analytics.Xamarin` from [GitHub](https://github.com/segmentio/Analytics.Xamarin)...
Expand Down
Loading