kotlin開發(fā)cli工具小技巧詳解

更新時間：2022年12月01日 10:32:54 作者：究極逮蝦戶

這篇文章主要為大家介紹了kotlin開發(fā)cli工具小技巧詳解，有需要的朋友可以借鑒參考下，希望能夠有所幫助，祝大家多多進(jìn)步，早日升職加薪

腳手架

腳手架是為了保證各施工過程順利進(jìn)行而搭設(shè)的工作平臺

而在程序開發(fā)過程中，每個工程或者說公司也都需要一個腳手架工具。通過腳手架命令行的形式簡化開發(fā)流程，避免發(fā)生一些人為的相對低級的問題，所以這個也就是為什么叫做腳手架的原因吧。

而由于每個公司的代碼規(guī)范都不同，一般情況下會主動讓開發(fā)同學(xué)進(jìn)行工程方面的cv操作，就是成本高并且容易出錯。這也就是為什么我們打算寫一些這樣的工具的原因。

在一般情況下，更多的程序猿會選擇用python去寫，因為腳本語言的靈活性，但是對于一個辣雞安卓來說會增加額外的學(xué)習(xí)成本，所以這就取決于有沒有天賦了，能不能對一門陌生的語言快速上手了。

這次文章會介紹的是用kotlin去構(gòu)建一個二進(jìn)制文件，通過這個來完成腳手架cli工具的建設(shè)。

開搞

demo 工程地址 TheNext

一開始的啟發(fā)在于有時候使用一些第三方工具的時候會提供一個jar包，然后只要輸入java -jar xxx.jar就可以使用這個jar包中的Main函數(shù)了。

因為是一個jar包，所以里面的內(nèi)容肯定也都是用jvm內(nèi)的幾種語言來進(jìn)行編寫的，那么這就讓我們這種老年選手看到了一絲絲的希望。

開發(fā)調(diào)試

先建立了一個java工程，然后構(gòu)建了一個main函數(shù)，之后開始進(jìn)行代碼編寫。但是如果每次都需要先打包之后在通過java -jar來執(zhí)行的話非常不便利開發(fā)并且debug。而且模擬入?yún)⒁不页５膼盒?，你也知道的程序猿都是懶人嗎?/p>

所以我們就借用了unittest的能力，對于入?yún)⑦M(jìn)行mock進(jìn)行簡單的調(diào)試功能了。

參考地址 github.com/Leifzhang/T…

class Sample {
    @Test
    fun help() {
        Next.main(
            arrayOf(
                "--help"
            )
        )
    }
    @Test
    fun testAndroidModule() {
        val file = File("")
        val moduleName = "strike-freedom"
        val groupName = "com.kronos.common"
        Next.main(
            arrayOf(
                "module", "android",
                "-file", file.absolutePath,
                "-name", moduleName,
                "-group", groupName
            )
        )
    }
    @Test
    fun testAndroidApplication() {
        val file = File("../app/")  
        val projectName = "freedom"
        Next.main(
            arrayOf(
                "project", "android",
                "-name", projectName,
                "-file", file.absolutePath
            )
        )
    }
}

此處我們將Main函數(shù)通過unittest來進(jìn)行模擬，這樣就可以方便我們在開發(fā)階段快速調(diào)試腳手架的能力了。

每個方法塊都可以認(rèn)為是一個運(yùn)行的入口，通過這個來模擬出程序所需要的入?yún)?。從而一邊完成了測試代碼的編寫，一邊完成了調(diào)試入口。

jcommander

這是一個讓我們可以更像模像樣的寫一個cli的入?yún)⒔馕龉ぞ?，即使參?shù)順序是錯亂的，我們?nèi)匀荒芙馕龀鑫覀兿胍臄?shù)據(jù)結(jié)構(gòu)，讓我們的工程看起來更正規(guī)一點。而且這個庫也被很多開源項目所使用，基本算的上是千錘百煉了，比如美團(tuán)的walle。

jcommander值得你一個star的

@Parameters(commandDescription = "args 參數(shù)")
class CommandEntity {
    @Parameter(
        names = ["-file", "-f"],
        required = true,
        converter = FileConverter::class,
        description = "生成目標(biāo)文件路徑"
    )
    lateinit var file: File
    @Parameter(
        names = ["-name"], required = true,
        description = "文件名"
    )
    lateinit var name: String
    @Parameter(names = ["-group", "-bundle", "-g", "-b"], description = "唯一標(biāo)識符")
    var group: String? = null
}

override fun handle(args: Array<String>) {
 val commandEntity = CommandEntity()
 JCommander.newBuilder().addObject(commandEntity).build().parse(*args)
}

實例demo如上，我也是參考了官方demo寫的。通過JCommander將args解析成對應(yīng)的數(shù)據(jù)實體結(jié)構(gòu)。

Main 函數(shù)聲明

我們要在build.gradle內(nèi)的jar的task中，聲明當(dāng)前jar的main函數(shù)，作為命令行工具的入口。否則打出來的jar包就會報沒有main函數(shù)的異常。

jar {
    exclude("**/module-info.class")
    /* from {
         configurations.runtimeClasspath.collect { it.isDirectory() ? it : zipTree(it) }
     }*/
    manifest {
        attributes 'Main-Class': 'com.kronos.mebium.Next'
    }
}

其中from的含義就是將一個jar包把所有的依賴都打到一起，從而形成一個fatjar,而后續(xù)因為使用了gradle提供的application插件，所以這行被我注釋了。

壓縮模板

我們這個腳手架最核心的就是把一部分工程模板壓縮成一個zip資源文件，打包帶入jar產(chǎn)物中。然后呢我這個人又比較懶，希望每次執(zhí)行打包的時候都進(jìn)行一次模板的壓縮替換，所以這里我通過一部分gradle task來進(jìn)行執(zhí)行了。

abstract class ZipTask extends DefaultTask {
    @InputDirectory
    Provider<File> library = project.objects.property(File)
    @OutputFile
    Provider<File> outputFile = project.objects.property(File)
    @TaskAction
    def doAction() {
        def outputFile = outputFile.get()
        createFileSafety(outputFile)
        compress(library.get(), outputFile)
    }
    static File compress(final File srcDir, final File zipFile) {
        ZipOutputStream zos = new ZipOutputStream(new FileOutputStream(zipFile))
        srcDir.eachFileRecurse({
            zos.putNextEntry(new ZipEntry(it.path - srcDir.path + (it.directory ? "/" : "")))
            if (it.file) {
                zos << it.bytes
            }
            zos.closeEntry()
        })
        zos.close()
        return zipFile
    }
    private static File createFileSafety(File file) {
        if (file.exists()) {
            file.delete()
        }
        if (!file.getParentFile().exists()) {
            file.getParentFile().mkdirs()
        }
        return file
    }
}

首先定義出一個task，然后定義好輸入輸出，輸入的是一個文件夾，輸出的則是一個zip的壓縮文件，輸入輸出的地址由外部來聲明。

def moduleTask = project.tasks.register("zipAndroidLib", ZipTask.class) {
    it.library.set(file("../library"))
    it.outputFile.set(file("./src/main/resources/zip/android/android.zip"))
}
def projectTask = project.tasks.register("zipAndroidProject", ZipTask.class) {
    it.library.set(file("../project"))
    it.outputFile.set(file("./src/main/resources/zip/android/project.zip"))
}
afterEvaluate {
    project.tasks.findByName("compileJava").dependsOn(moduleTask)
    project.tasks.findByName("compileJava").dependsOn(projectTask)
}

然后直接聲明處兩個task，之后把compileJava依賴到這兩個task上去，這樣就可以保證每次compileJava，這兩個task都會被執(zhí)行到了。編譯緩存我就不說了，大家自行領(lǐng)悟吧。