arrow-left Back to Announcements
DATE:
AUTHOR:
PowerSync Product Team
Kotlin Multiplatform SDK

PowerSync Kotlin Multiplatform SDK: v1.0.0-BETA28

DATE:
AUTHOR: PowerSync Product Team

We are excited to announce the release of version 1.0.0-BETA28 of the PowerSync Kotlin Multiplatform client SDK

Visit the full SDK reference to get started, for implementation details, and code snippets.

See the full changelog below.

Have any questions or feedback? Chat with us and the PowerSync community on Discord.

Changelog

1.0.0-BETA28

  • [ADDED] Enabled Full Text Search on iOS platforms. An example implementation is not yet available, however our JavaScript implementations can be used as a guide in the mean time, or reach out to us on Discord. (PR #145)

  • [ADDED] The ability to open the SQLite database given a custom dbDirectory path in the PowerSyncDatabase constructor. This is currently not supported on iOS due to internal driver restrictions. (PR #145)

  • [ADDED] For advanced use cases: The ability to update the schema for existing PowerSync clients using updateSchema(). (PR #154)

  • [IMPROVED] Unified concurrency model across platforms by introducing a pool of read connections and a single write connection, simplifying driver implementation and enabling concurrent reads. This also brings the architecture in line with other PowerSync SDKs. (PR #145)

  • [IMPROVED] Added queuing protection and warnings when connecting multiple PowerSync clients to the same database file, avoiding inconsistent state issues and improving the reliability of watched queries. (PR #146)

  • [IMPROVED] The Android SQLite driver now uses the Xerial JDBC library. This removes the requirement for users to add the jitpack Maven repository to their projects. (PR #145)

    // settings.gradle.kts example

    repositories {
        google()
        maven("https://jitpack.io") {
            content { includeGroup("com.github.requery") }

        }
        mavenCentral()
    }

  • [IMPROVED] Switched to statically linking SQLite on native platforms since dynamic extension loading is disabled on Apple platforms. (PR #147)

  • [FIXED] A bug where local only, insert only and view name overrides were not applied for schema tables. (PR #154)

  • [FIXED] Updated powersync-sqlite-core to v0.3.12, which fixes powersync_last_synced_at() returning stale information. 

1.0.0-BETA27

  • [ADDED] The ability to throttle watched queries via the optional throttleMs parameter. This will prevent these queries from re-running within the specified duration and therefore reduce the load for frequently updating tables.

  • [IMPROVED] Internally improved the query logic for watch() queries, by optimizing table update handling, enhancing thread safety, and simplifying the implementation (see the PR).

  • [FIXED] The uploading and downloading Sync Status indicators not correctly emitting status events.

1.0.0-BETA26

  • [ADDED] Support for sync bucket priorities to sync critical data first. Learn more.

  • [IMPROVED] Android: Add ProGuard rules to prevent methods called through JNI from being minified or removed.

1.0.0-BETA25

  • [IMPROVED] JVM Suport: Lower minimum supported version from 17 to 8.

1.0.0-BETA24

  • [IMPROVED] Internal handling of watch queries to avoid issues where updates are not being received due to transaction commits occurring after the query is run.

  • [IMPROVED] Throw and not just catch CancellationExceptions in runWrappedSuspending.

  • [FIXED] An issue in JVM build where columnNames was throwing an error due to the index of the JDBC driver starting at 1 instead of 0 as in the other drivers.

1.0.0-BETA23

  • [IMPROVED] Make execute and PowerSyncTransaction functions throwable for Swift.

1.0.0-BETA22

  • [FIXED] updateHasSynced internal null pointer exception.

1.0.0-BETA21

  • [IMPROVED] Error handling for Swift by adding @Throws annotation so errors can be handled in Swift.

  • [IMPROVED] Throw PowerSync exceptions for all public facing methods.

v1.0.0-BETA19 and v1.0.0-BETA20

  • [IMPROVED] Ability to use the column name to get the pertaining value when using the cursor instead of having to use the index number. The following functions now accept a column name parameter: getBoolean,getBooleanOptional,getString,getStringOptional, getLong,getLongOptional, getDouble,getDoubleOptional.

  • BREAKING CHANGE: This should not affect anyone, but we made KotlinPowerSyncCredentials, KotlinPowerSyncDatabase and KotlinPowerSyncBackendConnector private as these should never have been public.

v1.0.0-BETA18

  • BREAKING CHANGE: Move from async sqldelight calls to synchronous calls. This will only affect readTransaction and writeTransactionwhere the callback function is no longer asynchronous.

v1.0.0-BETA17

  • [FIXED] JVM builds on Windows.

v1.0.0-BETA16

  • [IMPROVED] Add close method to database methods.

  • [IMPROVED] Throw when error is a CancellationError and remove invalidation for all errors in streamingSync catch.

v1.0.0-BETA15

  • [FIXED] Updated powersync-sqlite-core to v0.3.8, which fixes a view migration issue (see details).

  • [IMPROVED] Increase maximum amount of columns from 63 to 1999.

v1.0.0-BETA14

  • [ADDED] JVM compatibility.

  • [FIXED] Reverted the previous iOS database updates as they were introducing further issues.

v1.0.0-BETA13

  • [FIXED] Move iOS database driver to use IO dispatcher which should avoid race conditions and improve performance.

v1.0.0-BETA12

  • [FIXED] Use transaction context in writeTransaction in BucketStorageImpl.

v1.0.0-BETA11

  • [FIXED] Update version to fix a deployment issue of the previous release.

v1.0.0-BETA10

  • [IMPROVED] Change Swift package name from PowerSync to PowerSyncKotlin.

v1.0.0-BETA9

  • [FIXED] Re-enable SKIE's SuspendInterop plugin.

  • [FIXED] Move transaction functions out of PowerSyncTransactionFactory to avoid threading issues in the Swift SDK.

v1.0.0-BETA8

  • [FIXED] Disable SKIE's SuspendInterop plugin to fix overriding suspend functions in Swift.

v1.0.0-BETA7

  • [IMPROVED] Updates Supabase connector to use supabase-kt version 3.

  • [IMPROVED] Handle Postgres error codes in the Supabase connector.

v1.0.0-BETA6

  • [FIXED] Custom Write Checkpoint application logic.

v1.0.0-BETA5

  • [FIXED] hasSynced not updating after disconnectAndClear.

  • [FIXED] An error being thrown in iOS app launch.

v1.0.0-BETA4

  • [FIXED] hasSynced was reset when the update function is run.

v1.0.0-BETA3

  • [ADDED]waitForFirstSync function - which resolves after the initial sync is completed. Usage example.

  • [ADDED] Support for client parameters to further filter data via sync rules. Example:

    val params = JsonParam.Map(
     mapOf(
        "name" to JsonParam.String("John Doe"),
        "age" to JsonParam.Number(30),
        "isStudent" to JsonParam.Boolean(false)
     )
)

connect(
   ...
   params = params
)

  • [ADDED] Validation (e.g. checking for duplicate table names) when the schema is generated.

  • [IMPROVED] Updated powersync-sqlite-core to v0.3.0, which significantly improves the performance of incremental sync (see details).

  • [IMPROVED] Added a warning if connector uploadData functions don't process CRUD items completely [original PR for more details].

  • [IMPROVED] Upgraded to Kotlin 2.0.20. This fixes issues related to using Kotlin with XCode 16.

v1.0.0-BETA2

  • [FXIED] Added a minSdk version to the build.gradle.kts file of the persistence module to resolve an error that was thrown.

v1.0.0-BETA1

  • Improved the API by changing from a Builder pattern to simply instantiating the database PowerSyncDatabase

    E.g. val db = PowerSyncDatabase(factory, schema)

  • Moved the SQLDelight models to a separate module to reduce export size.

  • Replaced the default Logger with Kermit Logger which allows users to more easily use and/or change Logger settings.

  • Introduced a callback context in transactions (see details in this PR)

    E.g. db.writeTransaction{ ctx -> ctx.execute(...) }

  • Quality enhancements summarized here.

  • And more.

Powered by LaunchNotes