KDoc：更改参数顺序

Question

我在 Kotlin

上的 伴随对象 中有以下参数

    companion object Constants {
    /**
     * Values for the various type of connection that a device can have.
     */
    const val CONNECTION_KEY = "Connection_type"
    const val CONNECTION_AUX = "AUX"
    const val CONNECTION_BLUETOOTH = "Bluetooth"
    const val CONNECTION_USB = "USB"

    /**
     * Unique IDs respectively for devices and media elements.
     */
    const val DEVICE_ID_KEY = "Device_ID"
    const val MEDIA_ID_KEY = "Media_ID"

    /**
     * Various keys that you can find in [Bundle] returned by [getMediaItems].
     */
    const val MEDIA_NAME_KEY = "Media_name"
    const val SONG_IDS_KEY = "Songs_ids"
    const val GENRE_IDS_KEY = "Genres_ids"
    const val ARTIST_IDS_KEY = "Artists_ids"
}

问题是，在 Kdoc 结果中，我发现它们按 alphabetical order

ARTIST_IDS_KEY

const val ARTIST_IDS_KEY: String

CONNECTION_AUX

const val CONNECTION_AUX: String

CONNECTION_BLUETOOTH

const val CONNECTION_BLUETOOTH: String

CONNECTION_KEY

Values for the various type of connection that a device can have.

const val CONNECTION_KEY: String

CONNECTION_USB

const val CONNECTION_USB: String

DEVICE_ID_KEY

Unique IDs respectively for devices and media elements.

const val DEVICE_ID_KEY: String

GENRE_IDS_KEY

const val GENRE_IDS_KEY: String

MEDIA_ID_KEY

const val MEDIA_ID_KEY: String

MEDIA_NAME_KEY

Various keys that you can find in Bundle returned by getMediaItems.

const val MEDIA_NAME_KEY: String

SONG_IDS_KEY

const val SONG_IDS_KEY: String

...有没有办法保持原来的顺序？

Answer 1

您可以通过在 code:

中对 kDoc 中的元素进行分组

companion object Constants {
    /**
     * Values for the various type of connection that a device can have.
     */
    object Connection {
        const val KEY = "Connection_type"
        const val AUX = "AUX"
        const val BLUETOOTH = "Bluetooth"
        const val USB = "USB"
    }

    /**
     * Unique IDs respectively for devices and media elements.
     */
    object IDs {
        const val DEVICE = "Device_ID"
        const val MEDIA = "Media_ID"
    }

    /**
     * Various keys that you can find in [Bundle] returned by [getMediaItems].
     */
    object BundleKeys {
        const val MEDIA_NAME = "Media_name"
        const val SONG_IDS = "Songs_ids"
        const val GENRE_IDS = "Genres_ids"
        const val ARTIST_IDS = "Artists_ids"   
    }
}

KDoc：更改参数顺序

KDoc: change parameters order

kotlin

kdoc

kotlin-dokka