The skip-keychain framework is available at https://github.com/skiptools/skip-keychain.git, which can be checked out and tested with skip test once Skip is installed.

SkipKeychain

Usage
Backups
Building
Testing

This is a Skip Swift/Kotlin library project providing a simple unified API to secure key/value storage. It uses the Keychain on Darwin platforms and EncyptedSharedPreferences on Android.

Usage

import SkipKeychain

let keychain = Keychain.shared

try keychain.set("value", forKey: "key")
assert(keychain.string(forKey: "key") == "value")

try keychain.removeValue(forKey: "key")
assert(keychain.string(forKey: "key") == nil)

Backups

Google recommends excluding encrypted shared preference files from backups to prevent restoring an encrypted file whose encryption key is lost. If your app targets devices running Android 11 or lower, follow the instructions here to create backup rules for your app and reference them from your AndroidManifest.xml. Your rules file should exclude SkipKeychain’s shared preferences, like so:

<?xml version="1.0" encoding="utf-8"?>
<full-backup-content>
    <exclude domain="sharedpref" path="tools.skip.SkipKeychain.xml"/>
</full-backup-content>

For newer devices, follow these instructions in addition to the steps above for older devices. Your additional rules file should contain the fllowing:

<?xml version="1.0" encoding="utf-8"?>
<data-extraction-rules>
  <cloud-backup>
    <exclude domain="sharedpref" path="tools.skip.SkipKeychain.xml"/>
  </cloud-backup>
  <device-transfer>
    <exclude domain="sharedpref" path="tools.skip.SkipKeychain.xml"/>
  </device-transfer>
</data-extraction-rules>

Building

This project is a Swift Package Manager module that uses the Skip plugin to transpile Swift into Kotlin.

Building the module requires that Skip be installed using Homebrew with brew install skiptools/skip/skip. This will also install the necessary build prerequisites: Kotlin, Gradle, and the Android build tools.

Testing

The module can be tested using the standard swift test command or by running the test target for the macOS destination in Xcode, which will run the Swift tests as well as the transpiled Kotlin JUnit tests in the Robolectric Android simulation environment.

Parity testing can be performed with skip test, which will output a table of the test results for both platforms.