Skip to content

Docs: correct the Android quickstart minimum API level and versions - #604

Open
amitthacker-maker wants to merge 1 commit into
cometchat:mainfrom
amitthacker-maker:fix/android-ios-quickstart-versions
Open

amitthacker-maker wants to merge 1 commit into
cometchat:mainfrom
amitthacker-maker:fix/android-ios-quickstart-versions

Conversation

@amitthacker-maker

Copy link
Copy Markdown

The Android getting-started page contradicted itself in two ways. It told developers to set a minimum API level of 24 while stating API 28 twice elsewhere, and it gave two different UI Kit versions for the same library in its two install tabs.

Found while building a minimal app from the quickstart. Every number below was read on 2026-11-06 from the artifact or registry that governs it.

Minimum API level: 24 becomes 28

Step 1 said "Set minimum API level to 24 or higher". The published AAR for com.cometchat:chatuikit-kotlin-android 6.1.1 declares android:minSdkVersion="28", so a project set to 24 fails the manifest merge.

The AI Quick Reference row and the prerequisites already said API 28. Step 1 was the only wrong one, and it is the line a developer actually follows, so the page read as correct while handing out a broken instruction. The new wording says where 28 comes from, so the next person does not have to rediscover it.

Versions

What Page said Now
cometchat-ui-kit (Version Catalog tab) 6.0.3 6.1.1
chatuikit-kotlin-android (Gradle tab) 6.1.0 6.1.1
chatuikit-compose-android 6.1.0 6.1.1
calls-sdk-android (both tabs) 5.0.1 5.1.0

All four read from the Cloudsmith maven-metadata.xml for each artifact on 2026-11-06. The UI Kit artifacts report release 6.1.1, and calls-sdk-android reports 5.1.0.

The first two rows are the same library, which is the self-contradiction: the two tabs disagreed by eight releases.

One judgement call worth flagging. calls-sdk-android 5.1.0 was published on 2026-11-05, one day before this change, and 5.0.4 is the settled alternative in the same line. I took 5.1.0, because a page naming a deliberately older release is how a quickstart ends up hiding a problem behind a stale version. If you would rather this sat on 5.0.4 until 5.1.0 has some age, say so and I will change it.

Scope

Android only. The iOS getting-started page has defects of the same kind, but fixing it needs a decision from the SDK team first, so it is deliberately not in this pull request rather than overlooked. Happy to go into that separately.

🤖 Generated with Claude Code

The page told developers to set a minimum API level of 24 while stating API
28 twice elsewhere on the same page, and gave two different UI Kit versions
for the same library in its two install tabs.

Minimum API level 24 to 28. The published AAR for chatuikit-kotlin-android
6.1.1 declares android:minSdkVersion="28", read from the artifact on the
Cloudsmith repository on 2026-11-06, so 24 fails the manifest merge. The AI
Quick Reference and the prerequisites already said API 28; Step 1, the line a
developer actually follows, was the one that was wrong.

Versions, all read from the Cloudsmith maven-metadata on 2026-11-06:

- Version Catalog said cometchat-ui-kit 6.0.3, Gradle tab said
  chatuikit-kotlin-android 6.1.0, for the same library. Both now 6.1.1.
- chatuikit-compose-android 6.1.0 to 6.1.1.
- calls-sdk-android 5.0.1 to 5.1.0, in both tabs.

Found by the growth marketing desk while building a minimal app from the
quickstart, and re-verified here against each published artifact rather than
against the earlier report.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
@mintlify

mintlify Bot commented Nov 6, 2026

Copy link
Copy Markdown

Preview approval required

This pull request comes from a fork, so Mintlify won't build a preview until someone with write access approves commit 3529a9c.

Approve preview

@amitthacker-maker

Copy link
Copy Markdown
Author

Superseded by #621.

This branch now conflicts with main, and half of it has gone stale in a way that would do harm. It raises the UI Kit from 6.1.0 to 6.1.1, but main has since moved to 6.2.0, so merging this would put the version back. The Calls SDK bump to 5.1.0 is already on main too.

The one part still unfixed is the minimum API level. Step 1 of the quickstart asks for 24 or higher, and both published UI Kit modules declare minSdkVersion 28, so a project created by following step 1 fails the manifest merge in step 2. Read from the published artifacts on 2026-11-18: chatuikit-kotlin-android 6.2.0 and chatuikit-compose-android 6.2.0 both declare 28, and calls-sdk-android 5.1.0 declares 26.

#621 carries that one line against current main. Closing this one is fine by me.

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Development

Successfully merging this pull request may close these issues.

2 participants