dotnet / dotnet/android

Generating documentation for bindings to a kotlin library (KDoc/dokka).

Open
#10,534 2 comments 0 reactions 0 assignees View on GitHub
need-attention needs-triage
Dominant language
C#
Stars
2.1k
Forks
579
Avg merge
1d 19h
Merged PRs (30d)
252

Description

### Android framework version

net9.0-android

### Affected platform version

.NET 9.0.304

### Description

How is one supposed to generate documentation for bindings of android libraries written in kotlin? Am I missing something? Unless I'm blind, I didn't see anything related to kotlin in the docs.

Neither JavaSourceJar nor JavaDocJar appear to work.

I'm assuming that is because neither KDoc nor the javadoc format dokka produces (nor any other dokka output) is supported.

### Steps to Reproduce

1. Make an android library in Kotlin
2. Add some documentation with KDoc comments to a class or function or somewhere
3. Build the aar and either an androidSourcesJar or javadocJar with dokka
4. Create a binding project
5. Add item group entries for the AndroidLibrary to the aar and either JavaSourceJar or JavaDocJar to the corresponding jar.
6. Set property group entries for GenerateDocumentationFile to true and AndroidJavadocVerbosity to full
7. Build
8. Observe no documentation in the output xml.

### Did you find any workaround?

_No response_

### Relevant log output

```shell

```

Contributor guide

No contributing guide indexed for this repository

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.