Setup FileKit Dialogs

Install and setup FileKit Dialogs in your Kotlin Multiplatform project

Installation

FileKit can helps you to display dialogs to the user like file, directory and photo pickers, save dialogs, camera and more. FileKit dialogs are available in two flavors:

build.gradle.kts

// Enables FileKit dialogs without Compose dependencies
implementation("io.github.vinceglb:filekit-dialogs:0.15.0")

// Enables FileKit dialogs with Composable utilities
implementation("io.github.vinceglb:filekit-dialogs-compose:0.15.0")

FileKit Dialogs integrates FileKit Core and automatically provides PlatformFile support.

Platform-specific setup

It’s required to setup FileKit Dialogs on Android and JVM targets. All other platforms are supported out of the box.

Android setup

Using filekit-dialogs needs an initialization step in your Android application.

This initialization step is not needed when using filekit-dialogs-compose.

FileKit needs to have access to the ActivityResultRegistry to handle the result of the file picker dialog. To do this, you need to add the following code to your MainActivity:

MainActivity.kt

class MainActivity : ComponentActivity() {
  override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)

    // Initialize FileKit
    FileKit.init(this)
  }
}

JVM setup

FileKit needs to have your application id to handle the app directory. Your application id is generally the package name or the name of your application. FileKit will use this appId as app directory.

We recommend you to initialize FileKit in your main.kt file:

main.kt

fun main() {
  // Initialize FileKit
  FileKit.init(appId = "MyApplication")

  // Start your application
  application {
      Window(onCloseRequest = ::exitApplication) {
          // ...
      }
  }
}

The application ID is used to create user-specific directories on different operating systems:

• Windows: %APPDATA%\your.application.id\
• macOS: ~/Library/Application Support/your.application.id/
• Linux: ~/.local/share/your.application.id/

Custom Cache and Data Directories

For applications that need custom directory paths (e.g., portable applications or specific deployment scenarios), you can specify custom cache and data directories:

main.kt

fun main() {
  val appDir = File(System.getProperty("user.home"), ".myapp")
  FileKit.init(
      appId = "MyApplication",
      filesDir = File(appDir, "data"),
      cacheDir = File(appDir, "cache")
  )

  // ...
}

ProGuard Configuration

If you’re using ProGuard or code obfuscation on JVM platforms, add the relevant rules to your proguard-rules.pro:

# Required on JVM for JNA-based integrations.
-keep class com.sun.jna.** { *; }
-keep class * implements com.sun.jna.** { *; }

# Required when using FileKit Dialogs on Linux (XDG Desktop Portal / DBus).
-keep class org.freedesktop.dbus.** { *; }
-keep class io.github.vinceglb.filekit.dialogs.platform.xdg.** { *; }
-keepattributes Signature,InnerClasses,RuntimeVisibleAnnotations

Linux setup

If using JVM target and Linux distribution, you need to add the following module in your build.gradle.kts file:

build.gradle.kts

compose.desktop {
    application {
        nativeDistributions {
            linux {
                modules("jdk.security.auth")
            }
        }
    }
}

This prevents a NoClassDefFoundError in some cases. Read more about this issue in the GitHub issue #107.