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结果中，我发现它们是按字母顺序排列的。

ARTIST_IDS_KEY

const ARTIST_IDS_KEY: String

CONNECTION_AUX

const CONNECTION_AUX: String

CONNECTION_BLUETOOTH

const CONNECTION_BLUETOOTH: String

CONNECTION_KEY

设备可以拥有的各种类型连接的值。

const CONNECTION_KEY: String

CONNECTION_USB

const CONNECTION_USB: String

DEVICE_ID_KEY

设备和媒体元素的唯一ID。

const DEVICE_ID_KEY: String

GENRE_IDS_KEY

const GENRE_IDS_KEY: String

MEDIA_ID_KEY

const MEDIA_ID_KEY: String

MEDIA_NAME_KEY

您可以在getMediaItems返回的Bundle中找到各种键。

const MEDIA_NAME_KEY: String

SONG_IDS_KEY

const SONG_IDS_KEY: String

..。有什么办法来维持原来的订单吗？

Answer 1

通过在代码中对元素进行分组，可以对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"   
    }
}