PlatformTools is a Kotlin Multiplatform library designed to provide platform-specific utilities and tools for managing operating systems, application installation, and release fetching seamlessly across various platforms. The library is modular and divided into three main components: core, appmanager, and releasefetcher.

• Platform Detection
  Identify the current platform or operating system, such as Windows, Mac, Linux, Android, iOS, JS, or WASM.

• App Installation Management
  Check and request permissions for installing applications, install and uninstall apps, and manage application packages seamlessly.

• Release Management
  Fetch the latest release information from GitHub repositories, check for updates, and download release files tailored to the platform.
• File Downloader
  Easily download application files with progress tracking through the Downloader class.

Add the following dependencies to your Kotlin Multiplatform project:

implementation("io.github.kdroidfilter.platformtools:core:0.1.1")

implementation("io.github.kdroidfilter.platformtools:appmanager:0.1.1")

implementation("io.github.kdroidfilter.platformtools:releasefetcher:0.1.1")

The main goal of this library is to serve as a versatile toolkit for implementing platform-specific utilities. While this approach might seem contrary to the expect/actual pattern of Kotlin Multiplatform, PlatformTools fills a specific gap:

• It enables operating system detection within the JVM, which is not natively supported by KMP.
• It allows OS detection in common code for minor functionalities where embedding such logic can be beneficial.

The core module provides tools for platform detection, including support for enums to represent different platforms:

import io.github.kdroidfilter.platformtools.Platform
import io.github.kdroidfilter.platformtools.getPlatform

val platform = getPlatform()
println("Current platform: $platform")

The appmanager module provides an interface for managing application installation and uninstallation. For each platform, the required file format is as follows:

• Android: APK file
• Windows: MSI file
• Linux: DEB file
• Mac: PKG file

On Android, it is also possible to uninstall applications:

import io.github.kdroidfilter.platformtools.appmanager.getAppInstaller

val appInstaller = getAppInstaller()

// Uninstall an app by package name
appInstaller.uninstallApp("com.example.app") { success, message ->
    if (success) {
        println("Uninstall started: $message")
    } else {
        println("Failed to uninstall: $message")
    }
}

// Uninstall the current app
appInstaller.uninstallApp { success, message ->
    if (success) {
        println("Uninstall started: $message")
    } else {
        println("Failed to uninstall: $message")
    }
}

The releasefetcher module simplifies release management with GitHub:

import io.github.kdroidfilter.platformtools.releasefetcher.github.GitHubReleaseFetcher

val releaseFetcher = GitHubReleaseFetcher(owner = "owner", repo = "repo")

// Check for updates
releaseFetcher.checkForUpdate { latestVersion, changelog ->
    println("New version available: $latestVersion")
    println("Changelog: $changelog")
}

// Fetch download link for the current platform
val release = releaseFetcher.getLatestRelease()
val downloadLink = releaseFetcher.getDownloadLinkForPlatform(release!!)
println("Download link: $downloadLink")

The Downloader class provides functionality for downloading application files with progress tracking:

import io.github.kdroidfilter.platformtools.releasefetcher.Downloader

val downloader = Downloader()

suspend fun downloadAppFile(downloadUrl: String) {
    downloader.downloadApp(downloadUrl) { percentage, file ->
        if (percentage >= 0) {
            println("Download progress: $percentage%")
        } else {
            println("Download failed")
        }

        file?.let {
            println("Downloaded file: ${it.absolutePath}")
        }
    }
}

PlatformTools is licensed under the MIT License. Feel free to use, modify, and distribute the library under the terms of the license.

Contributions are welcome! If you want to improve this library, please feel free to submit a pull request or open an issue.