docs/ui-material.md
author Da Risk <da_risk@geekorum.com>
Tue, 06 May 2025 13:53:02 -0400
changeset 92 d0a027c33366
parent 84 f1e51fe391c2
child 97 20ba708adda9
permissions -rw-r--r--
build: update to compose-multiplatform 1.8.0
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
84
f1e51fe391c2 docs: add documentation for different license sources and UI
Da Risk <da_risk@geekorum.com>
parents:
diff changeset
     1
Ui-Material
f1e51fe391c2 docs: add documentation for different license sources and UI
Da Risk <da_risk@geekorum.com>
parents:
diff changeset
     2
===========
f1e51fe391c2 docs: add documentation for different license sources and UI
Da Risk <da_risk@geekorum.com>
parents:
diff changeset
     3
f1e51fe391c2 docs: add documentation for different license sources and UI
Da Risk <da_risk@geekorum.com>
parents:
diff changeset
     4
Setup
f1e51fe391c2 docs: add documentation for different license sources and UI
Da Risk <da_risk@geekorum.com>
parents:
diff changeset
     5
=====
f1e51fe391c2 docs: add documentation for different license sources and UI
Da Risk <da_risk@geekorum.com>
parents:
diff changeset
     6
f1e51fe391c2 docs: add documentation for different license sources and UI
Da Risk <da_risk@geekorum.com>
parents:
diff changeset
     7
Add the dependency to your project
f1e51fe391c2 docs: add documentation for different license sources and UI
Da Risk <da_risk@geekorum.com>
parents:
diff changeset
     8
f1e51fe391c2 docs: add documentation for different license sources and UI
Da Risk <da_risk@geekorum.com>
parents:
diff changeset
     9
```kotlin title="build.gradle.kts"
f1e51fe391c2 docs: add documentation for different license sources and UI
Da Risk <da_risk@geekorum.com>
parents:
diff changeset
    10
dependencies {
f1e51fe391c2 docs: add documentation for different license sources and UI
Da Risk <da_risk@geekorum.com>
parents:
diff changeset
    11
    implementation("com.geekorum.aboutoss:ui-material:<latest-version>")
f1e51fe391c2 docs: add documentation for different license sources and UI
Da Risk <da_risk@geekorum.com>
parents:
diff changeset
    12
}
f1e51fe391c2 docs: add documentation for different license sources and UI
Da Risk <da_risk@geekorum.com>
parents:
diff changeset
    13
```
f1e51fe391c2 docs: add documentation for different license sources and UI
Da Risk <da_risk@geekorum.com>
parents:
diff changeset
    14
f1e51fe391c2 docs: add documentation for different license sources and UI
Da Risk <da_risk@geekorum.com>
parents:
diff changeset
    15
Usage
f1e51fe391c2 docs: add documentation for different license sources and UI
Da Risk <da_risk@geekorum.com>
parents:
diff changeset
    16
=====
f1e51fe391c2 docs: add documentation for different license sources and UI
Da Risk <da_risk@geekorum.com>
parents:
diff changeset
    17
f1e51fe391c2 docs: add documentation for different license sources and UI
Da Risk <da_risk@geekorum.com>
parents:
diff changeset
    18
The [OpenSourceDependenciesNavHost](api/ui/material2/com.geekorum.aboutoss.ui.material/-open-source-dependencies-nav-host.html)
f1e51fe391c2 docs: add documentation for different license sources and UI
Da Risk <da_risk@geekorum.com>
parents:
diff changeset
    19
composable allows to display the licenses. 
f1e51fe391c2 docs: add documentation for different license sources and UI
Da Risk <da_risk@geekorum.com>
parents:
diff changeset
    20
It takes an [OpenSourceLicensesViewModel](api/ui/common/com.geekorum.aboutoss.ui.common/-open-source-licenses-view-model/index.html)
f1e51fe391c2 docs: add documentation for different license sources and UI
Da Risk <da_risk@geekorum.com>
parents:
diff changeset
    21
that you can create with the [LicenseInfoRepository](license-sources.md) of your choice.
f1e51fe391c2 docs: add documentation for different license sources and UI
Da Risk <da_risk@geekorum.com>
parents:
diff changeset
    22
f1e51fe391c2 docs: add documentation for different license sources and UI
Da Risk <da_risk@geekorum.com>
parents:
diff changeset
    23
```kotlin
f1e51fe391c2 docs: add documentation for different license sources and UI
Da Risk <da_risk@geekorum.com>
parents:
diff changeset
    24
val licenseInfoRepository = LicenseeLicenseInfoRepository()
f1e51fe391c2 docs: add documentation for different license sources and UI
Da Risk <da_risk@geekorum.com>
parents:
diff changeset
    25
val viewModel = viewModel<OpenSourceLicensesViewModel>(factory = OpenSourceLicensesViewModel.Factory(licenseInfoRepository))
f1e51fe391c2 docs: add documentation for different license sources and UI
Da Risk <da_risk@geekorum.com>
parents:
diff changeset
    26
OpenSourceDependenciesNavHost(
f1e51fe391c2 docs: add documentation for different license sources and UI
Da Risk <da_risk@geekorum.com>
parents:
diff changeset
    27
    openSourceLicensesViewModel = viewModel,
f1e51fe391c2 docs: add documentation for different license sources and UI
Da Risk <da_risk@geekorum.com>
parents:
diff changeset
    28
    navigateUp = {
f1e51fe391c2 docs: add documentation for different license sources and UI
Da Risk <da_risk@geekorum.com>
parents:
diff changeset
    29
        // close screen
f1e51fe391c2 docs: add documentation for different license sources and UI
Da Risk <da_risk@geekorum.com>
parents:
diff changeset
    30
    }
f1e51fe391c2 docs: add documentation for different license sources and UI
Da Risk <da_risk@geekorum.com>
parents:
diff changeset
    31
)
f1e51fe391c2 docs: add documentation for different license sources and UI
Da Risk <da_risk@geekorum.com>
parents:
diff changeset
    32
```
f1e51fe391c2 docs: add documentation for different license sources and UI
Da Risk <da_risk@geekorum.com>
parents:
diff changeset
    33
f1e51fe391c2 docs: add documentation for different license sources and UI
Da Risk <da_risk@geekorum.com>
parents:
diff changeset
    34
Android
f1e51fe391c2 docs: add documentation for different license sources and UI
Da Risk <da_risk@geekorum.com>
parents:
diff changeset
    35
=======
f1e51fe391c2 docs: add documentation for different license sources and UI
Da Risk <da_risk@geekorum.com>
parents:
diff changeset
    36
f1e51fe391c2 docs: add documentation for different license sources and UI
Da Risk <da_risk@geekorum.com>
parents:
diff changeset
    37
The [OpenSourceLicensesActivity](api/ui/material2/com.geekorum.aboutoss.ui.material/-open-source-licenses-activity/index.html) is configured to work with the [OSS Licenses Gradle Plugin](https://github.com/google/play-services-plugins/tree/main/oss-licenses-plugin)
f1e51fe391c2 docs: add documentation for different license sources and UI
Da Risk <da_risk@geekorum.com>
parents:
diff changeset
    38
You can launch the activity like this:
f1e51fe391c2 docs: add documentation for different license sources and UI
Da Risk <da_risk@geekorum.com>
parents:
diff changeset
    39
f1e51fe391c2 docs: add documentation for different license sources and UI
Da Risk <da_risk@geekorum.com>
parents:
diff changeset
    40
```kotlin
f1e51fe391c2 docs: add documentation for different license sources and UI
Da Risk <da_risk@geekorum.com>
parents:
diff changeset
    41
val intent = Intent(this, OpenSourceLicensesActivity::class.java)
f1e51fe391c2 docs: add documentation for different license sources and UI
Da Risk <da_risk@geekorum.com>
parents:
diff changeset
    42
startActivity(intent)
f1e51fe391c2 docs: add documentation for different license sources and UI
Da Risk <da_risk@geekorum.com>
parents:
diff changeset
    43
```
f1e51fe391c2 docs: add documentation for different license sources and UI
Da Risk <da_risk@geekorum.com>
parents:
diff changeset
    44
f1e51fe391c2 docs: add documentation for different license sources and UI
Da Risk <da_risk@geekorum.com>
parents:
diff changeset
    45
f1e51fe391c2 docs: add documentation for different license sources and UI
Da Risk <da_risk@geekorum.com>
parents:
diff changeset
    46
Desktop
f1e51fe391c2 docs: add documentation for different license sources and UI
Da Risk <da_risk@geekorum.com>
parents:
diff changeset
    47
=======
f1e51fe391c2 docs: add documentation for different license sources and UI
Da Risk <da_risk@geekorum.com>
parents:
diff changeset
    48
f1e51fe391c2 docs: add documentation for different license sources and UI
Da Risk <da_risk@geekorum.com>
parents:
diff changeset
    49
On Desktop the [OpenSourceLicensesWindow](api/ui/material2/com.geekorum.aboutoss.ui.material/-open-source-licenses-window.html) is configured to work with [licensee](https://github.com/cashapp/licensee).
f1e51fe391c2 docs: add documentation for different license sources and UI
Da Risk <da_risk@geekorum.com>
parents:
diff changeset
    50
You can use it like this:
f1e51fe391c2 docs: add documentation for different license sources and UI
Da Risk <da_risk@geekorum.com>
parents:
diff changeset
    51
f1e51fe391c2 docs: add documentation for different license sources and UI
Da Risk <da_risk@geekorum.com>
parents:
diff changeset
    52
```kotlin
f1e51fe391c2 docs: add documentation for different license sources and UI
Da Risk <da_risk@geekorum.com>
parents:
diff changeset
    53
OpenSourceLicensesWindow(onCloseRequest = {
f1e51fe391c2 docs: add documentation for different license sources and UI
Da Risk <da_risk@geekorum.com>
parents:
diff changeset
    54
    // close window
f1e51fe391c2 docs: add documentation for different license sources and UI
Da Risk <da_risk@geekorum.com>
parents:
diff changeset
    55
})
f1e51fe391c2 docs: add documentation for different license sources and UI
Da Risk <da_risk@geekorum.com>
parents:
diff changeset
    56
```
f1e51fe391c2 docs: add documentation for different license sources and UI
Da Risk <da_risk@geekorum.com>
parents:
diff changeset
    57