Skip to content

DOC-14097-platform-support-compat-matrix #1078

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.

Sign up for GitHub

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

Open
iamfortune wants to merge 7 commits into
base: release/4.1
Choose a base branch
from
+264 −443
Open

DOC-14097-platform-support-compat-matrix #1078

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
7 commits
Select commit Hold shift + click to select a range
68b395e
added test content
iamfortune Mar 11, 2026
183d1ac
remove test content
iamfortune Mar 11, 2026
7b901f0
add platform and compat support for C
iamfortune Mar 11, 2026
c62fa95
update compat + platform support for csharp
iamfortune Mar 11, 2026
1f631b4
add supported os
iamfortune Mar 11, 2026
491c7a2
update the compat + platform support for swift
iamfortune Mar 11, 2026
3a8d9a0
update as note
iamfortune Mar 12, 2026
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
2 changes: 1 addition & 1 deletion modules/android/nav-android.adoc
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -51,7 +51,7 @@ include::partial$_set_page_context_for_android.adoc[]
* https://docs.couchbase.com/mobile/{version-maintenance-android}/couchbase-lite-android-ktx[Kotlin Extensions]

* xref:android:upgrade.adoc[Upgrade]

-
* Troubleshooting
** xref:android:new-logging-api.adoc[]
** xref:android:troubleshooting-queries.adoc[Troubleshooting Queries]
Expand Down
71 changes: 25 additions & 46 deletions modules/android/pages/compatibility.adoc
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,16 +1,11 @@

= Compatibility
:page-aliases: product/java-android-compatibility.adoc
:page-role:
:description: Couchbase Lite framework and Sync Gateway compatibility


:source-language: Java


:source-language: Kotlin


[abstract]
--
Description -- _{description}_ +
Expand All @@ -21,7 +16,6 @@ Related Content -- xref:ROOT:cbl-whatsnew.adoc[What's New] | xref:android:rele
[#couchbase-litesync-gateway-matrix]
== Couchbase Lite/Sync Gateway Matrix


The table below summarizes the compatible versions of Couchbase Lite with Sync Gateway.

.Sync Gateway and Couchbase Lite Compatibility Matrix
Expand All @@ -31,7 +25,6 @@ The table below summarizes the compatible versions of Couchbase Lite with Sync G
.2+^.>| Sync Gateway Versions ↓
9+| Couchbase Lite →

^| 1.4 *footnote:eos-cbl[This Couchbase Lite version is End of Support]]*
^| 2.0
^| 2.1
^| 2.5 - 2.8
Expand All @@ -40,17 +33,7 @@ The table below summarizes the compatible versions of Couchbase Lite with Sync G
^| 3.2.0
^| 3.3.0
^| 4.0.0

| 1.4 *footnote:eos-sgw[This Sync Gateway version is End of Support]* and 1.5 *footnote:eol-sgw[This Sync Gateway version is End of Life]*
| image:ROOT:yes.png[]
| image:ROOT:no.png[]
| image:ROOT:no.png[]
| image:ROOT:no.png[]
| image:ROOT:no.png[]
| image:ROOT:no.png[]
| image:ROOT:no.png[]
| image:ROOT:no.png[]
| image:ROOT:no.png[]
^| 4.1.0

| 2.0 and 2.1
| image:ROOT:yes.png[]
Expand All @@ -60,7 +43,7 @@ The table below summarizes the compatible versions of Couchbase Lite with Sync G
| image:ROOT:yes.png[]
| image:ROOT:yes.png[]
| image:ROOT:yes.png[]
| image:ROOT:yes.png[]
| image:ROOT:no.png[]
| image:ROOT:no.png[]

| 2.5 to 2.8 +
Expand All @@ -72,23 +55,22 @@ with delta sync disabled
| image:ROOT:yes.png[]
| image:ROOT:yes.png[]
| image:ROOT:yes.png[]
| image:ROOT:yes.png[]
| image:ROOT:no.png[]
| image:ROOT:no.png[]

| 2.5 to 2.8 +
with delta sync enabled
| image:ROOT:no.png[]
| image:ROOT:no.png[]
| image:ROOT:no.png[]
| image:ROOT:yes.png[]
| image:ROOT:yes.png[]
| image:ROOT:yes.png[]
| image:ROOT:yes.png[]
| image:ROOT:yes.png[]
| image:ROOT:no.png[]
| image:ROOT:no.png[]

| 3.0.0
| image:ROOT:no.png[]
| image:ROOT:yes.png[]
| image:ROOT:yes.png[]
| image:ROOT:yes.png[]
Expand All @@ -97,9 +79,9 @@ with delta sync enabled
| image:ROOT:yes.png[]
| image:ROOT:yes.png[]
| image:ROOT:no.png[]
| image:ROOT:no.png[]

| 3.1.0
| image:ROOT:no.png[]
| image:ROOT:yes.png[]
| image:ROOT:yes.png[]
| image:ROOT:yes.png[]
Expand All @@ -108,9 +90,9 @@ with delta sync enabled
| image:ROOT:yes.png[]
| image:ROOT:yes.png[]
| image:ROOT:no.png[]
| image:ROOT:no.png[]

| 3.2.0
| image:ROOT:no.png[]
| image:ROOT:yes.png[]
| image:ROOT:yes.png[]
| image:ROOT:yes.png[]
Expand All @@ -119,9 +101,9 @@ with delta sync enabled
| image:ROOT:yes.png[]
| image:ROOT:yes.png[]
| image:ROOT:no.png[]
| image:ROOT:no.png[]

| 3.3.0
| image:ROOT:no.png[]
| image:ROOT:yes.png[]
| image:ROOT:yes.png[]
| image:ROOT:yes.png[]
Expand All @@ -130,9 +112,10 @@ with delta sync enabled
| image:ROOT:yes.png[]
| image:ROOT:yes.png[]
| image:ROOT:no.png[]
| image:ROOT:no.png[]

| 4.0.0
| image:ROOT:no.png[]
| image:ROOT:yes.png[]
| image:ROOT:yes.png[]
| image:ROOT:yes.png[]
| image:ROOT:yes.png[]
Expand All @@ -144,6 +127,10 @@ with delta sync enabled

|===

// NOTE Verify CBL 4.1 / Sync Gateway compatibility rows with engineering
// before publishing. The 4.1 column above follows the same pattern as 4.0 (compatible
// with SGW 4.0.0 only). Confirm whether any additional SGW versions gain compatibility.

[#operating-system-sdk-support]
== Operating System SDK Support

Expand All @@ -153,9 +140,7 @@ The table below summarizes the Operating System SDK versions supported by Couchb
[cols="1,^1,^1,^1,^1,^1,^1,^1,^1,^1,^1,^1"]
|===


^.>h|
^.>h| 2.0
^.>h| 2.1
^.>h| 2.5
^.>h| 2.6
Expand All @@ -166,35 +151,35 @@ The table below summarizes the Operating System SDK versions supported by Couchb
^.>h| 3.2
^.>h| 3.3
^.>h| 4.0
^.>h| 4.1

h| Android
| https://docs-archive.couchbase.com/home/index.html[archive link]
| https://docs-archive.couchbase.com/home/index.html[archive link]
| https://docs-archive.couchbase.com/home/index.html[archive link]
| https://docs-archive.couchbase.com/home/index.html[archive link]
| https://docs-archive.couchbase.com/home/index.html[archive link]
| xref:2.8@couchbase-lite:android:supported-os.adoc[link]
| xref:3.0@couchbase-lite:android:supported-os.adoc[link]
| xref:3.1@couchbase-lite:android:supported-os.adoc[link]
| xref:3.2@couchbase-lite:android:supported-os.adoc[link]
| xref:3.3@couchbase-lite:android:supported-os.adoc[link]
| xref:android:supported-os.adoc[link]
| xref:android:supported-os.adoc[link]

h| C
| -
| -
| -
| -
| -
| -
| xref:3.0@couchbase-lite:c:supported-os.adoc[link]
| xref:3.1@couchbase-lite:c:supported-os.adoc[link]
| xref:3.2@couchbase-lite:c:supported-os.adoc[link]
| xref:3.3@couchbase-lite:c:supported-os.adoc[link]
| xref:c:supported-os.adoc[link]
| xref:c:supported-os.adoc[link]

h| iOS
| https://docs-archive.couchbase.com/home/index.html[archive link]
h| iOS
| https://docs-archive.couchbase.com/home/index.html[archive link]
| https://docs-archive.couchbase.com/home/index.html[archive link]
| https://docs-archive.couchbase.com/home/index.html[archive link]
Expand All @@ -205,10 +190,9 @@ h| iOS
| xref:3.2@couchbase-lite:swift:supported-os.adoc[link]
| xref:3.3@couchbase-lite:swift:supported-os.adoc[link]
| xref:swift:supported-os.adoc[link]
| xref:swift:supported-os.adoc[link]


h| Java
| -
h| Java
| -
| -
| -
Expand All @@ -219,9 +203,9 @@ h| Java
| xref:3.2@couchbase-lite:java:supported-os.adoc[link]
| xref:3.3@couchbase-lite:java:supported-os.adoc[link]
| xref:java:supported-os.adoc[link]
| xref:java:supported-os.adoc[link]

h| JavaScript
| -
h| JavaScript
| -
| -
| https://docs-archive.couchbase.com/home/index.html[archive link]
Expand All @@ -232,9 +216,9 @@ h| JavaScript
| xref:3.2@couchbase-lite:ROOT:javascript.adoc[link]
| xref:3.3@couchbase-lite:ROOT:javascript.adoc[link]
| xref:ROOT:javascript.adoc[link]
| xref:ROOT:javascript.adoc[link]

h| .NET
| https://docs-archive.couchbase.com/home/index.html[archive link]
h| .NET
| https://docs-archive.couchbase.com/home/index.html[archive link]
| https://docs-archive.couchbase.com/home/index.html[archive link]
| https://docs-archive.couchbase.com/home/index.html[archive link]
Expand All @@ -245,10 +229,10 @@ h| .NET
| xref:3.2@couchbase-lite:csharp:supported-os.adoc[link]
| xref:3.3@couchbase-lite:csharp:supported-os.adoc[link]
| xref:csharp:supported-os.adoc[link]
| xref:csharp:supported-os.adoc[link]

|===


[#related-content]
== Related Content
++++
Expand All @@ -263,7 +247,6 @@ h| .NET
* xref:android:supported-os.adoc[Supported Platforms]
* xref:cbl-whatsnew.adoc[What's New]


.

[.column]
Expand All @@ -277,7 +260,6 @@ h| .NET

.


[.column]
====== {empty}
.Tutorials
Expand All @@ -287,9 +269,6 @@ https://docs.couchbase.com/tutorials/[Tutorials]

.


++++
</div>
++++


++++
30 changes: 24 additions & 6 deletions modules/android/pages/supported-os.adoc
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,16 +1,11 @@

= Supported Operating System Versions
:page-aliases: product/java-android-supported-os.adoc
:page-role: -toc
:description: Couchbase Lite on Android -- the OS and SDK versions on which this framework is supported


:source-language: Java


:source-language: Kotlin


[abstract]
--
Description -- _{description}_ +
Expand All @@ -33,7 +28,7 @@ Couchbase does not test against, nor guarantee support for, uncertified Android

.Supported versions
[#supported-os-versions]
[%autowidth.stretch#supported-os-versions]
[%autowidth.stretch]
|===
|Platform |Runtime architectures |Minimum API Level

Expand All @@ -54,4 +49,27 @@ Couchbase does not test against, nor guarantee support for, uncertified Android
|24
|===

[#bluetooth-transport-requirements]
== Bluetooth Transport Requirements

[NOTE]
--
Bluetooth Low Energy (BLE) transport for the Multipeer Replicator requires *Android API 29 (Android 10) or later*, due to the availability of BLE L2CAP support on that API level.

Devices running API 24--28 can still use Couchbase Lite 4.1 with all non-Bluetooth features, including Wi-Fi-based Multipeer replication.
If your application targets API 24--28, do not include `.bluetooth` in your `MultipeerReplicatorConfiguration.transports` set.
--

[cols="1,^1", options="header"]
|===
|Feature |Minimum API Level

|Couchbase Lite core
|24

|Multipeer Replicator (Wi-Fi)
|24

|Multipeer Replicator (Bluetooth LE)
|29
|===
Loading
Loading