I have been releasing multiplatform stuff to MC wi...

# multiplatform

[addamsson]

I have been releasing multiplatform stuff to MC with the old architecture but with this new one it doesn't work. MC only accepts artifacts which have sources jar and javadoc jar and I can't create a javadoc jar out of a common project. With the old way I just released each platform-specific implementation by hand but with kotlin-multiplatform this is not an option because they are not separate projects in Gradle.

[h0tk3y]

Yes, sources JARs are created by default, but you need to add Javadoc JARs manually, by using the publishing { ... } DSL of the maven-publish plugin, basically adding another artifact to all of the publications the kotlin-multiplatform plugin creates.

[addamsson]

I tried using dokka

[addamsson]

from this example

[addamsson]

https://guides.gradle.org/building-kotlin-jvm-libraries/

[addamsson]

but this is not working for multiplatform projects

[addamsson]

since there is no java

[addamsson]

https://github.com/gradle-guides/building-kotlin-jvm-libraries/blob/master/samples/code/my-kotlin-library/build.gradle.kts#L51

[addamsson]

I'm also not sure where to put the publishing part

[addamsson]

because this document uses a mavenPublication method at the end: https://kotlinlang.org/docs/reference/building-mpp-with-gradle.html#setting-up-a-multiplatform-project

[addamsson]

What is the relationship between mavenPublication and publishing?

[addamsson]

But the whole documentation is very lacking and I was not able to find the source code of the plugin either 😞

[h0tk3y]

publishing { ... } is the DSL provided by the Gradle maven-publish plugin. It contains the publications under the publications named domain object collection. The MPP docs describe the names of the publications that the kotlin-multiplatform plugin creates by default here: https://kotlinlang.org/docs/reference/building-mpp-with-gradle.html#publishing-a-multiplatform-library. The mavenPublication { ... } is a shorthand for configuring a publication for a specific target, it is equivalent to configuring publishing { publications { myTargetName { ... } } }.

[h0tk3y]

The docs coverage will improve over time, for sure. 🙂 Please submit issues (https://kotl.in/issue) for any specific topic that you think is not covered good enough so we can properly monitor this, or submit pull requests to the docs directly if you are willing to contribute.

[addamsson]

I don't see the sources.jar generated in my projects

[addamsson]

although I followed the directions to the latter

[addamsson]

that's why I asked this here

[addamsson]

It would be a great help if I could use build.gradle.kts so then I could navigate the source code and see what's there

[addamsson]

for example right now I have no idea how I add signed artifacts to my build

[addamsson]

which is a prerequisite of publishing to Maven Central

[addamsson]

so this is what I have in my config now:

kotlin {
    targets {
        fromPreset(presets.jvm, 'jvm') {
            tasks.getByName(compilations.main.compileKotlinTaskName).kotlinOptions {
                jvmTarget = '1.8'
            }
            tasks.getByName(compilations.test.compileKotlinTaskName).kotlinOptions {
                jvmTarget = '1.8'
            }
        }
        fromPreset(presets.js, 'web') {
            tasks.getByName(compilations.main.compileKotlinTaskName).kotlinOptions {
                sourceMap = true
            } 
        }
    }
}

and no sources.jar gets generated, yet the docs state that it will be generated by default

[addamsson]

By default, a sources JAR is added to each publication in addition to its main artifact. The sources JAR contains the sources used by the main compilation of the target.

[addamsson]

I could add this according to the docs:

mavenPublication { 
                artifactId = 'sample-lib-jvm'
                artifact(jvmJavadocJar)
            }

but what's jvmJavadocJar? is this some magic variable? Where does it come from? How do I add javadoc for common projects?

[addamsson]

even if I add this to my config nothing new gets generated in the build/libs directory