close
前言

終於算是忙完了一個階段!!!從4月份開始,工作內容以及職務上都進行了較大的變動,最直接的就是從海外項目組調到了國內項目組。國內項目組目前有兩個應用在同時跑着,而且還有幾個馬甲包也要維護,不知道大家發版的時候覆雜不複雜,反正我們每次發版的時候都需要經歷--打包、加固、對齊、重簽名、打渠道包、上傳雲存儲、生成渠道推廣鏈接、生成內更SQL、上傳Mapping文件等等步驟(xN),簡直是折磨人啊。

所以首要任務就是做出一套自動化的基礎設施來,最初直接考慮到的方案是【「Jenkins+Docker+360命令行加固+VasDolly+Bugly等」】的方案(下一篇文章會給大家分享該方案),整個過程下來基本能達到自動化的目的。就這麼穩定的跑了一個多月,然而,在5月下旬的時候360加固發布了一個通知,大致內容就是免費版用戶無法使用命令行的加固方式了,只能手動用工具加固。這就導致最初的方案直接垮掉,我花費了個把月學習Linux,Pipeline,Docker,還製作了各種鏡像,結果突然不能用了,心塞。然而路還是要繼續走下去的,在儘量不花錢的前提下,想到了開發桌面端工具的方案。

功能一覽

接下來先給大家一覽下桌面端工具的基本功能,我的電腦是Windows的,所以都是基於Windows平台下的build-tools相關工具進行開發的。首先大部分的功能都是基於jar或exe文件,那麼在Java(Kotlin)中我們可以通過如下方式來調用這些外部程序,exec其實最終也是調用了ProcessBuilder,整體的原理就是如此:

//方式1Runtime.getRuntime().exec(cmd)//方式2ProcessBuilder(cmd)多渠道打包

這是該工具最基本的功能,使用「VasDolly」方案對APK文件進行多渠道打包(當然該APK文件需要是簽名好的)。

多渠道包命令行工具即 VasDolly.jar,該文件可以在上述GitHub倉庫中找到,常用的命令如下:

//獲取指定APK的簽名方式java-jarVasDolly.jarget-s[源apk地址]//獲取指定APK的渠道信息java-jarVasDolly.jarget-c[源apk地址]//刪除指定APK的渠道信息java-jarVasDolly.jarremove-c[源apk地址]//通過指定渠道字符串添加渠道信息java-jarVasDolly.jarput-c"channel1,channel2"[源apk地址][apk輸出目錄]//通過指定某個渠道字符串添加渠道信息到目標APKjava-jarVasDolly.jarput-c"channel1"[源apk地址][輸出apk地址]//通過指定渠道文件添加渠道信息java-jarVasDolly.jarput-cchannel.txt[源apk地址][apk輸出目錄]//提供了FastMode,生成渠道包時不進行強校驗,速度可提升10倍以上java-jarVasDolly.jarput-cchannel.txt-f[源apk地址][apk輸出目錄]對齊和簽名

上傳應用市場前,APK文件大部分會被市場要求進行加固,無論是使用騰訊樂固還是360加固等方式,加固後APK的簽名信息總會被破壞,所以我們需要對加固後的APK文件重新進行簽名。

配置簽名

首先我們需要準備好應用的簽名信息,該工具支持導入簽名文件,並保存相應的StorePass、KeyAlias、KeyPass信息,如下:

當選擇APK後,程序會判斷選擇的APK是否進行了簽名,如果沒有簽名,那麼就會彈窗提醒用戶選擇配置好的簽名文件進行簽名,簽名之後才可進行多渠道打包的過程。註:該功能現已升級,添加簽名文件的時候綁定包名,選擇apk後會自動獲取到包名然後查找到對應的簽名文件自動對齊簽名處理,無需手動進行選擇了。

對齊

簽名的過程則需要用到Android SDK中的兩個文件,以Windows系統為例,一個是處理對齊的【build-tools\版本號\zipalign.exe】文件,另一個則是用來簽名的【build-tools\版本號\lib\apksigner.jar】文件。

我們先看下zipalign工具的官方說明:

zipalign is a zip archive alignment tool. It ensures that all uncompressed files in the archive are aligned relative to the start of the file. This allows those files to be accessed directly via mmap(2), removing the need to copy this data in RAM and reducing your app's memory usage. zipalign是一種zip歸檔對齊工具。它確保存檔中所有未壓縮的文件都與文件的開頭對齊。這允許通過mmap直接訪問這些文件,無需將這些數據複製到RAM中,並減少應用程序的內存使用。

zipalign should be used to optimize your APK file before distributing it to end-users. This is done automatically if you build with Android Studio. This documentation is for maintainers of custom build systems. 在將APK文件分發給用戶之前,應使用zipalign優化APK文件。如果您使用Android Studio進行構建,這將自動完成。本文檔面向定製構建系統的維護人員。

Google官方現在要求在使用apksigner對APK文件進行簽名前需要先使用zipalign來優化APK文件,具體命令如下,以Windows下的zipalign.exe文件為例:

//對齊APKzipalign.exe-p-f-v4[源apk路徑][輸出apk路徑]//驗證APK是否對齊zipalign.exe-c-v4[源apk路徑]

其他相關的內容可以參閱官網 zipalign 。

簽名

當APK文件對齊後,就可以給對齊後的APK進行簽名操作了,簽名的方法有兩種,我們這裡單說使用--ks選項指定密鑰庫的方式,具體命令如下:

java-jarapksigner.jarsign--verbose--ks[KeyStore文件路徑]--ks-passpass:[KeyStorePass]--ks-key-alias[KeyAlias]--key-passpass:[KeyPass]--out[輸出apk路徑][源apk路徑]

命令本身很簡單,別搞錯參數就好,尤其是兩個密碼的參數,後面需要使用【pass:密碼】。輸入密碼這裡還支持其他格式,如果有需要請參閱官網 apksigner 。

加固、對齊、重簽名後,這個apk就可以進行多渠道打包的處理了,然後即可發布到相關市場和渠道。

其他內容

在項目中還有很多其他的相關配置,比如發版的時候需要對APP進行應用內的更新通知。那麼就需要我們填寫發版的相關信息,版本名、版本號、更新日誌等等內容都需要完善(可根據APK文件的命名來獲取部分信息),然後通過這些信息生成應用內部更新的SQL語句,發送釘釘通知給相關後台人員處理。通知這一步又用到了釘釘的SDK,該工具支持配置釘釘機器人Webhook地址以及需要艾特的人員信息。

打出來的這些包都需要統一上傳到雲存儲上面,這一步使用了AWS的雲存儲SDK,可以配置雲存儲桶地址等信息,免去人工手動上傳apk的煩惱。上傳完畢後會根據文件名生成相應的下載鏈接並通知到釘釘群,以便市場人員獲取到渠道最新的推廣鏈接等。

桌面端開發

接下來就說下桌面端的開發過程,至於Compose MultiPlatform的介紹,請參閱官網地址。本文主要就描述下一些針對桌面端的相關需求。

彈窗

關於彈窗,ComposeDesktop同樣提供了Dialog可組合函數:

@ComposablepublicfunDialog(onCloseRequest:()->kotlin.Unit,state:androidx.compose.ui.window.DialogState,visible:kotlin.Boolean,title:kotlin.String,icon:androidx.compose.ui.graphics.painter.Painter?,undecorated:kotlin.Boolean,transparent:kotlin.Boolean,resizable:kotlin.Boolean,enabled:kotlin.Boolean,focusable:kotlin.Boolean,onPreviewKeyEvent:(androidx.compose.ui.input.key.KeyEvent)->kotlin.Boolean,onKeyEvent:(androidx.compose.ui.input.key.KeyEvent)->kotlin.Boolean,content:@Composable()(DialogWindowScope.()->kotlin.Unit)):kotlin.Unit{/*compiledcode*/}

大部分的參數都可以直接看出他的作用,主要看一下state參數,該參數可以控制彈窗的位置及大小,例如我們配置一個在屏幕中央,寬高為500*300dp的彈窗,那麼示例代碼如下:

state=DialogState(position=WindowPosition(Alignment.Center),size=DpSize(500.dp,300.dp),)

不過這個彈窗沒有陰影,如果想添加的話可以內部套一層Surface來做出陰影效果:

Surface(modifier=Modifier.fillMaxSize().padding(20.dp),elevation=10.dp,shape=RoundedCornerShape(16.dp))文件選擇器

關於文件選擇器這一塊目前Compose還沒有專門的函數,但是我們還是可以使用原有的方案:

javax.swing.JFileChooser
java.awt.FileDialog

個人還是更偏向於使用JFileChooser,因為使用第二種方案的話,在頁面重組的情況下總是會莫名的彈出選擇框來。一個簡單的文件選擇器如下所示:

privatefunshowFileSelector(suffixList:Array<String>,onFileSelected:(String)->Unit){JFileChooser().apply{//設置頁面風格try{vallookAndFeel=UIManager.getSystemLookAndFeelClassName()UIManager.setLookAndFeel(lookAndFeel)SwingUtilities.updateComponentTreeUI(this)}catch(e:Throwable){e.printStackTrace()}fileSelectionMode=JFileChooser.FILES_ONLYisMultiSelectionEnabled=falsefileFilter=FileNameExtensionFilter("文件過濾",*suffixList)valresult=showOpenDialog(ComposeWindow())if(result==JFileChooser.APPROVE_OPTION){valdir=this.currentDirectoryvalfile=this.selectedFileprintln("Currentapkdir:${dir.absolutePath}${dir.name}")println("Currentapkname:${file.absolutePath}${file.name}")onFileSelected(file.absolutePath)}}}

該方式在使用的過程中也有一定的缺陷,就是每次打開文件彈窗總是會卡頓一下,所以後續也是有了尋找其他高效選擇文件方式的想法。

文件拖拽

選擇文件除了上面的彈窗選擇方式,還有另一種神奇的方式 - 拖拽選擇,本來也是沒有頭緒,然而在Slack閒逛的時候發現了Jim Sproch推薦了一篇相關的文章:https://dev.to/tkuenneth/from-swing-to-jetpack-compose-desktop-2-4a4h 。看完後也是恍然大悟,但是在Compose Desktop中,window是整個窗口,如何讓某一個指定的區域響應我們的文件拖拽事件呢?

還記得在Android上有ComposeView吧,用來嵌套原來的那一套View體系。那麼在這裡我也是採用了類似的這麼一種方式,實例一個空的JPanel控件然後給它安排到window中去。具體位置及大小的設置呢,在Compose中可以通過 「onPlaced(onPlaced: (LayoutCoordinates) -> Unit)」 修飾符來獲取到,示例代碼如下所示:

@OptIn(ExperimentalComposeUiApi::class)@ComposablefunDropBoxPanel(modifier:Modifier,window:ComposeWindow,component:JPanel=JPanel(),onFileDrop:(List<String>)->Unit){valdropBoundsBean=remember{mutableStateOf(DropBoundsBean())}Box(modifier=modifier.onPlaced{dropBoundsBean.value=DropBoundsBean(x=it.positionInWindow().x,y=it.positionInWindow().y,width=it.size.width,height=it.size.height)}){LaunchedEffect(true){component.setBounds(dropBoundsBean.value.x.roundToInt(),dropBoundsBean.value.y.roundToInt(),dropBoundsBean.value.width,dropBoundsBean.value.height)window.contentPane.add(component)valtarget=object:DropTarget(component,object:DropTargetAdapter(){overridefundrop(event:DropTargetDropEvent){event.acceptDrop(DnDConstants.ACTION_REFERENCE)valdataFlavors=event.transferable.transferDataFlavorsdataFlavors.forEach{if(it==DataFlavor.javaFileListFlavor){vallist=event.transferable.getTransferData(it)asList<*>valpathList=mutableListOf<String>()list.forEach{filePath->pathList.add(filePath.toString())}onFileDrop(pathList)}}event.dropComplete(true)}}){}}SideEffect{component.setBounds(dropBoundsBean.value.x.roundToInt(),dropBoundsBean.value.y.roundToInt(),dropBoundsBean.value.width,dropBoundsBean.value.height)}DisposableEffect(true){onDispose{window.contentPane.remove(component)}}}}

實際運行效果如下,個人感覺基本還是能達到目的的:

數據的保存

最開始的時候,功能很少,每個配置的數據都是使用了txt文件來一行行保存,但是到了後來功能越來越複雜,單純的按行來處理貌似有點捉襟見肘了,所以考慮使用json來保存複雜的類型數據。

json數據的處理從原生JSON到FastJson,Gson,Moshi等都已經體驗過了,於是乎便採用了之前未使用過的「Jackson」。然而不得不說,就目前為止,jackson是我用過最簡潔、優雅的一款解析庫。

假如我有一個List類型的列表數據,那麼當我要把這個數據存儲到文件的時候只需:

jacksonObjectMapper().writeValue(File,List<String>)

而從文件中讀取數據也是簡單的狠啊:

//方式1vallist=jacksonObjectMapper().readValue<List<String>>(jsonFile)//方式2vallist:List<String>=jacksonObjectMapper().readValue(jsonFile)

這種簡潔真的是深入我心。繼續深入了解下Jackson,你會發現它的可擴展性以及可定製性都很強,簡直相見恨晚啊。之前也是在一個舒適圈待習慣了,這次主動跳出來居然有了意想不到的收穫。

但是呢,每個框架也會有它自己的注意點,比如jackson,屬性命名不可以是is開頭,否則序列化等就會報錯。這點似乎在阿里巴巴JAVA手冊中好像也有提到,具體原因請大家自行百度(Google)。

資源的拷貝

當我們使用[java -jar xxx.jar]命令執行jar文件的時候,需要明確指定 jar文件的地址,但是在Compose Desktop中我們要怎麼存放並讀取這個jar文件呢 ?我們可以從Compose Desktop中讀取並展示圖片的相關代碼中得到啟發,假如有一個sample.svg圖標文件存放到了項目的 resources 文件夾下,那麼我們在引用這張圖片的時候就可以使用:

painterResource("sample.svg")

我們點進去這個方法看下:

@OptIn(ExperimentalComposeUiApi::class)@ComposablefunpainterResource(resourcePath:String):Painter=painterResource(resourcePath,ResourceLoader.Default)@ExperimentalComposeUiApi@ComposablefunpainterResource(resourcePath:String,loader:ResourceLoader):Painter=when(resourcePath.substringAfterLast(".")){"svg"->rememberSvgResource(resourcePath,loader)"xml"->rememberVectorXmlResource(resourcePath,loader)else->rememberBitmapResource(resourcePath,loader)}

裡面居然有個ResourceLoader類,這名字一聽就有戲啊,大概率就是我們需要的內容,而傳遞的默認參數是ResourceLoader.Default,那麼就看下Default的源碼吧:

//==========Resources.desktop.kt文件==========@ExperimentalComposeUiApiinterfaceResourceLoader{companionobject{/***Resourceloaderwhichiscapabletoloadresourcesfrom`resources`folderinanapplication's*project.Abilitytoloadfromdependentmodulesresourcesisnotguaranteedinthefuture.*Useexplicit`ClassLoaderResourceLoader`instanceifsuchguaranteeisneeded.*/@ExperimentalComposeUiApivalDefault=ClassLoaderResourceLoader()}funload(resourcePath:String):InputStream}@ExperimentalComposeUiApiclassClassLoaderResourceLoader:ResourceLoader{overridefunload(resourcePath:String):InputStream{//TODO(https://github.com/JetBrains/compose-jb/issues/618):probablyweshouldn'tuse//contextClassLoaderhere,asitisnotdefinedinthreadscreatedbynon-JVMvalcontextClassLoader=Thread.currentThread().contextClassLoader!!valresource=contextClassLoader.getResourceAsStream(resourcePath)?:(::ClassLoaderResourceLoader.javaClass).getResourceAsStream(resourcePath)returnrequireNotNull(resource){"Resource$resourcePathnotfound"}}}//==========ClassLoader類==========publicInputStreamgetResourceAsStream(Stringname){Objects.requireNonNull(name);URLurl=getResource(name);try{returnurl!=null?url.openStream():null;}catch(IOExceptione){returnnull;}}publicURLgetResource(Stringname){Objects.requireNonNull(name);URLurl;if(parent!=null){url=parent.getResource(name);}else{url=BootLoader.findResource(name);}if(url==null){url=findResource(name);}returnurl;}

上述源碼的整個邏輯基本上就是兩步,根據資源文件名獲取到資源文件,然後獲取資源文件的輸入流。看到這裡其實我們已經有兩種方案了:

方案一:直接拿到文件的URL然後獲取到文件的路徑
方案二:根據文件的輸入流,將文件重新保存到本機相關目錄

然而事情並沒有這麼簡單,如果我們使用方案一,那麼在編譯運行的時候完全沒有問題,所有的資源文件會被保存到【\build\processedResources\jvm】下,此時我們直接可以通過文件的URL獲取到文件路徑,然後調用即可。但是,當我們打包成安裝包後,例如在Windows下使用packageMsi命令打包出msi文件並安裝到電腦上後,運行程序,這時候你就會發現資源文件所在的路徑就很奇怪,例如我的工程下是【C:\Program Files\工程名\app\工程名-jvm-1.0-SNAPSHOT-xxxxxx.jar**!/**資源文件名】,也就是說所有的資源文件被打包進了這個快照文件,如果此時直接使用該路徑運行java -jar 等命令,那麼肯定就會報錯了。

所以最穩妥的方式還是使用方案二,使用ResourceLoader獲取到資源文件流然後重新保存到本機上的相關目錄就好了,偽代碼如下:

ResourceLoader.Default.load(resourcesPath).use{inputStream->valfos=FileOutputStream(file)valbuffer=ByteArray(1024)varlen:Intwhile(((inputStream.read(buffer).also{len=it}))!=-1){fos.write(buffer,0,len)}fos.flush()inputStream.close()fos.close()}打包MSI

在Windows環境下打包Msi格式安裝包的時候,有一個downloadWix的Task,該Task涉及到了Wix資源的下載,如下 :

Task :downloadWix Download https://github.com/wixtoolset/wix3/releases/download/wix3112rtm/wix311-binaries.zip

在IDEA中下載可能會非常的緩慢,此時我們可以複製上述地址,登上梯子,然後直接去GitHub下載。下載完畢後直接放入【/build/wixToolset】目錄下即可,再次編譯速度就會起飛了。

總結

簡直沒想到啊,作為一個Android開發者,現在藉助Compose Desktop開發起桌面端居然能這麼的輕車熟路,我對Compose真是越來越喜歡了。

另外呢,跳出業務這一段時間來處理這些東西也讓我對干預APK的打包等過程從理論邁出了實踐的一步,同時對市場和運營同學的工作也有了更多了解,通過該工具幫助其處理了部分重複機械式的工作,部門間的感情也得到了進一步的增溫(狗頭滑稽)。

就編到這吧,桌面工具還需要持續的維護跟優化,基本是面向市場和運營同事編程了。關於開頭說的Jenkins那一套其實早就寫好了,是鄙人少有的萬字長文,但是中間變故太大,一直也沒發布出來,接下來會重新整理下並發布,還請大家多多指正。

---END---


推薦閱讀

Compose 跨平台現狀

10個問題帶你看懂 Compose 跨平台

Jetpack Compose 編寫 AndroidTV 應用


arrow
arrow
    全站熱搜
    創作者介紹
    創作者 鑽石舞台 的頭像
    鑽石舞台

    鑽石舞台

    鑽石舞台 發表在 痞客邦 留言(0) 人氣()