[Android] Move url encoding to protocol

[kiftio]

What changes are you making?

Moves the responsibility of constructing ECP-compliant checkout URLs into EmbeddedCheckoutProtocol itself via a new url() function. Previously, UriExtensions.kt in the Android platform contained its own implementation of appendEcpParams that manually managed ec_version and ec_delegate query parameters. That logic has been replaced with a call to EmbeddedCheckoutProtocol.url(), which now owns the canonical URL-building behaviour for the protocol.

The new EmbeddedCheckoutProtocol.url() function:

• Appends ec_version set to SPEC_VERSION
• Optionally appends ec_delegate as a comma-separated list of delegation strings
• Strips any caller-supplied ec_version or ec_delegate values before appending its own, making it idempotent
• Preserves all other existing query parameters
• Falls back to returning the original URL if parsing fails or the URI is opaque

The appendEcpParams() extension in the Android platform is simplified to delegate directly to EmbeddedCheckoutProtocol.url(), and the hardcoded specVersion parameter is removed from all call sites.

How to test

1. Run the UriExtensionsTest suite on Android and confirm all existing appendEcpParams tests pass.
2. Run the EmbeddedCheckoutProtocolTest suite and confirm the new url() tests pass, covering:
   • ec_version is appended and ec_delegate is omitted when no delegations are provided
   • Multiple delegations are joined with a comma in ec_delegate
   • Existing non-protocol query parameters are preserved
   • Caller-supplied ec_version/ec_delegate values are replaced (idempotency)
   • An empty delegations list removes any pre-existing ec_delegate value

---

Before you merge

Important

• I've added tests to support my implementation
• I have read and agree with the Contribution Guidelines
• I have read and agree with the Code of Conduct
• I've updated the relevant platform README (platforms/swift/README.md and/or platforms/android/README.md)

---

Releasing a new Swift version?

• I have bumped the version in ShopifyCheckoutKit.podspec
• I have bumped the version in platforms/swift/Sources/ShopifyCheckoutKit/ShopifyCheckoutKit.swift
• I have updated platforms/swift/CHANGELOG.md
• I have updated the SwiftPM/CocoaPods version snippets in platforms/swift/README.md (major version only)

Releasing a new Android version?

• I have bumped checkoutKitAndroid in platforms/android/gradle/libs.versions.toml
• I have updated platforms/android/CHANGELOG.md
• I have updated the Gradle/Maven version snippets in platforms/android/README.md

Tip

See the Contributing documentation for the full release process per platform.

[kiftio]

• [Android] Expose fulfillmentChange #340 : 2 dependent PRs (#288 , #342 )
• [Android] Add support for ec_auth and ec_color_scheme #326
• [Android] Move url encoding to protocol #324 👈 (View in Graphite)
• [Android] publish packages independently #329
• [Android] extract checkout protocol module #315
• main

This stack of pull requests is managed by Graphite. Learn more about stacking.

[github-actions]

React Native — Coverage Report

Lines	Statements	Branches	Functions
	91.66% (319/348)	87.86% (181/206)	100% (82/82)

[github-actions]

Package Size

Platform	Artifact	Base	Head	Delta
Android	release AAR	167.9 KiB	167.2 KiB	-674 B

Measured from the PR base SHA and PR head SHA. This comment reports package artifact sizes only; it is not a final app binary-size report.

[markmur]

Just a heads up that I've changed this to an options struct argument for Swift in this PR to add support for colorScheme and auth. It scales better than adding new arguments for every param added to the spec

• [Protocol/Swift] Add support for ec_auth / ec_color_scheme #325

[markmur]

Looks good. Might be worth incorporating the changes from this PR before shipping but I'll leave it up to you

• #325

[kiftio]

Merge activity

• Jun 25, 9:26 AM UTC: A user started a stack merge that includes this pull request via Graphite.
• Jun 25, 9:46 AM UTC: Graphite rebased this pull request as part of a merge.
• Jun 25, 10:06 AM UTC: @kiftio merged this pull request with Graphite.