Merge pull request #7498 from segmentio/sunset-legacy-libraries

Sunset legacy libraries

Author: stayseesong

src/connections/sources/catalog/libraries/mobile/android/android-faqs.md

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

src/connections/sources/catalog/libraries/mobile/android/changelog.md

@@ -2,5 +2,8 @@
 title: Analytics-Android Changelog
 repo: analytics-android
 strat: android
+custom_ranking:
+  heading: 0
+  position: 99999
 ---
 {% include content/changelog.html %}

src/connections/sources/catalog/libraries/mobile/android/index.md

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

src/connections/sources/catalog/libraries/mobile/android/middleware.md

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

src/connections/sources/catalog/libraries/mobile/android/quickstart.md

@@ -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!

src/connections/sources/catalog/libraries/mobile/android/troubleshooting.md

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

src/connections/sources/catalog/libraries/mobile/android/wear.md

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

src/connections/sources/catalog/libraries/mobile/ios/changelog.md

@@ -2,5 +2,8 @@
 title: Analytics-iOS Changelog
 repo: analytics-ios
 strat: ios
+custom_ranking:
+  heading: 0
+  position: 99999
 ---
 {% include content/changelog.html %}

src/connections/sources/catalog/libraries/mobile/ios/index.md

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

src/connections/sources/catalog/libraries/mobile/ios/ios-faqs.md

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

src/connections/sources/catalog/libraries/mobile/ios/ios14-guide.md

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

src/connections/sources/catalog/libraries/mobile/ios/middleware.md

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

src/connections/sources/catalog/libraries/mobile/ios/quickstart.md

@@ -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/).

src/connections/sources/catalog/libraries/mobile/ios/troubleshooting.md

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

src/connections/sources/catalog/libraries/mobile/react-native/index.md

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