成人午夜视频全免费观看高清-秋霞福利视频一区二区三区-国产精品久久久久电影小说-亚洲不卡区三一区三区一区

井井有條的代碼庫(kù),才是工作中最大的幸福

2021-02-13    分類: 網(wǎng)站建設(shè)

圖源:unsplash

假設(shè)你剛剛加入新的公司新的團(tuán)隊(duì),要開(kāi)始接觸編碼庫(kù)相關(guān)的工作。你會(huì)面臨的第一個(gè)問(wèn)題就是:在哪添加團(tuán)隊(duì)項(xiàng)目的源文件呢?

問(wèn)得好。新團(tuán)隊(duì)有三個(gè)源目錄可供添加文件,你得分清哪個(gè)是你想用的,哪個(gè)是組員用的,哪里的文件是需要重構(gòu)的。

Slack iOS團(tuán)隊(duì)多年來(lái)在編碼庫(kù)方面都做的較好。因?yàn)楹脦状蜗胍M建一些源文件,但又缺少編碼庫(kù)的架構(gòu)模式,再者是近些年開(kāi)發(fā)人員越來(lái)越多,我們來(lái)到了這個(gè)團(tuán)隊(duì)。


從頂層開(kāi)始

我們大約有13000個(gè)文件(還在不斷增多),27個(gè)左右的頂層目錄,Objective-C和Swift的混合文件,大約有40個(gè)iOS開(kāi)發(fā)人員在一個(gè)monorepo中工作。

Slack iOS Xcode File Hierarchy2017

這些是所有文件層次結(jié)構(gòu)狀態(tài)的真實(shí)照片。新來(lái)的員工都在不斷抱怨入了編碼庫(kù),而我們已經(jīng)習(xí)慣操控這些混亂的目錄,一開(kāi)始的痛苦已經(jīng)不記得了。

我們有無(wú)數(shù)的源代碼目錄(特別是iOS,SlackCocoaSDK和Slack目錄),而且確定目錄要耗費(fèi)好長(zhǎng)時(shí)間,然后再?zèng)Q定如何添加文件。此外,我們決定給編碼庫(kù)增添新的工具,但是目前Xcode項(xiàng)目的狀態(tài)不能很好地支持新增添工具的運(yùn)行。

所以,我和一組ios開(kāi)發(fā)人員決定開(kāi)始制定以下幾點(diǎn)規(guī)則:

1.讓任何新老開(kāi)發(fā)人員都能快速方便地添加新文件。

2.在目錄中遵循我們的設(shè)計(jì)模式

3.借助工具能夠自己維持新的且層次結(jié)構(gòu)簡(jiǎn)潔的文件夾

這將分為兩個(gè)步驟:先將頂層目錄移動(dòng)到連貫的序列中(主要目標(biāo)目錄、擴(kuò)展目錄、框架等),然后是大任務(wù)——源文件夾的組建。

頂層目錄的移動(dòng)不存在爭(zhēng)議,也不難進(jìn)行??赡苄枰獛讉€(gè)開(kāi)發(fā)員一同花費(fèi)幾周的時(shí)間。首次移動(dòng)中,我們學(xué)到了一些后面階段能用到的技——錯(cuò)過(guò)高峰期處理大的移動(dòng),始終合并master,及時(shí)瀏覽評(píng)論。

合并沖突不是過(guò)程中唯一棘手的事情,實(shí)際上我們可以用xcodegen更好地消除沖突,大部分沖突都存在于項(xiàng)目文件中。我們也想保存git歷史記錄,能一直一目了然地看到git和finder中的文件。但我們傾向更簡(jiǎn)單的方式,讓所有人員參與進(jìn)來(lái),拖放文件到主頁(yè)。

Slack iOS Xcode Hierarchy 2017(左) and 2018 (右)

從2018年9月的這張圖可以看出,我們已經(jīng)能夠成功組建頂層目錄,讓每一個(gè)目錄都適用且都是頂層目。


組建源文件

現(xiàn)在是時(shí)候處理iOS、SlackCocoaSDK和Slack中的源文件,把它們?nèi)恳苿?dòng)到App或Source中。

老實(shí)說(shuō),筆者很怕這一部分。我們需要有一個(gè)清晰的模式,能讓團(tuán)隊(duì)所有的開(kāi)發(fā)員都參與進(jìn)來(lái),規(guī)則和工具都要確保移動(dòng)方便,工程師能清楚地看到自己是否出現(xiàn)失誤。

圖源:unsplash

筆者對(duì)層次結(jié)構(gòu)的模式展開(kāi)了很多調(diào)查,竟然發(fā)現(xiàn)關(guān)于文件夾組建的文章少之又少。Uber在這篇文章中寫了他們是如何移動(dòng)到monorepo中的(https://eng.uber.com/ios-monorepo/)。這對(duì)我們?nèi)绾螌⒋a庫(kù)分為小模塊(規(guī)模較?。┨峁┝藛l(fā)。

最后筆者為團(tuán)隊(duì)提供了三個(gè)選擇:

· 功能構(gòu)建

· 主題(基于體系結(jié)構(gòu)的組織)

· 本體(基于關(guān)系或類似分組的組織)

團(tuán)隊(duì)會(huì)先集中主力在高級(jí)功能,然后才是主題或功能目錄中的MVVM+C。這是新結(jié)構(gòu)中的一個(gè)文件夾:

/FeatureFolder
 /Coordinators
 /Models
 /Tests
 /Functional
 /Mocks
 /Unit /ViewModels
 /Views

移動(dòng)源文件是一項(xiàng)冗長(zhǎng)繁雜的工程。處理合并沖突讓人冒火,搜索文件名稱空間來(lái)看是否將所有功能文件都拖拽到目錄中要比最初想得更難記住,而且移動(dòng)的大部分文件都不符合剛開(kāi)始設(shè)定的文件夾規(guī)則。

不過(guò)好在有一些勇士挺身而出,做了偉大的舉措——將iOS,SlackCocoaSDK, 和Slack都移動(dòng)到App/Source中。

2020年1月層次結(jié)構(gòu)文件夾的截圖:

Slack Xcode File Hierarchy2020

在移動(dòng)這三個(gè)大型源目錄時(shí),我們提出Danger規(guī)則會(huì)阻止向這些目錄中添加文件,因此會(huì)開(kāi)始用我們的新模式。

Danger是持續(xù)集成系統(tǒng)中會(huì)用到的工具,可以執(zhí)行提交后的自動(dòng)檢查,同時(shí)將警告和錯(cuò)誤信息發(fā)到PRS上。這是大致模樣:

has_slack_directory_additions= !git.added_files.grep(/Slack/).empty?has_slackcocoasdk_directory_additions =!git.added_files.grep(/SlackCocoaSDK/).empty?has_ios_directory_additions =!git.added_files.grep(/iOS/).empty?if has_slack_directory_additions ||has_slackcocoasdk_directory_additions || has_ios_directory_additions fail(‘This PR is introducing new files intodirectories that are
 closed for adding new files. Pleaseadd files to App/Source using
 the new convention found inAdding a file to SlackiOS’, sticky: false)end


遵循Linter

到這里還沒(méi)有結(jié)束,我們?nèi)孕枰苿?dòng)新源目錄、App/Source中的內(nèi)容。這里列了“文件夾內(nèi)務(wù)管理”過(guò)程中的一些規(guī)則:

1.文件夾名稱不用留多余的空間(類似Bazel這類工具效果不是很好)

2.不要像“Helper”或“Uitility”那樣顛倒文件順序

3.共同定位測(cè)試(如果測(cè)試與源代碼都位于同一個(gè)功能目錄中,什么樣的方式能更容易找到測(cè)試呢?)

4.分類文件和文件夾?。ㄕl(shuí)不愛(ài)字母排序?!)

5.確保文件處于文件夾中,并且文件要與合適的目標(biāo)頂層目錄相關(guān)聯(lián)。

圖源:unsplash

有一條規(guī)則是真的需要共同定位測(cè)試,所以我們選擇Danger 規(guī)則。任何添加了新文件的新PR都無(wú)法加到App/Tests中。

大致如下:

has_app_test_directory_additions= !git.added_files.grep(/Test/).empty?if has_app_test_directory_additions fail(‘This PR is introducing new files intodirectories that are
 closed for adding new files. Pleaseadd co-locate tests using the new convention found in iOS Folder HousekeepingChecklist or feel free to ask in #ios-testing-folder-structure’,sticky: false)end

文件夾組創(chuàng)建一個(gè)Slack渠道,以供人們?cè)诓淮_定是否添加文件的時(shí)候進(jìn)行咨詢。對(duì)于往哪添加文件的困惑會(huì)比你想的多,甚至小移動(dòng)都會(huì)帶來(lái)很大麻煩。

我們已經(jīng)有了很大的進(jìn)步,得到了來(lái)自更優(yōu)秀iOS團(tuán)隊(duì)的支持,但等待我們的是更多的事情。

這不是一個(gè)人能做好的工作,你需要跟編碼庫(kù)工作環(huán)節(jié)中的每一位人員協(xié)同合作起來(lái)。你需要更好的團(tuán)隊(duì),并不只是為了移動(dòng)文件,而是修飾規(guī)則,添加更多的工具。有更多人的參與意味著很多人會(huì)從中學(xué)習(xí),之后便有能力教他人如何在編碼庫(kù)工作中添加文件。

成功和幸福的秘方很簡(jiǎn)單:假如你跟我們一樣有monorepo,那就組建一個(gè)團(tuán)隊(duì),制定硬性且能快速實(shí)現(xiàn)的規(guī)定。

規(guī)則可以被打破,你跟任何開(kāi)發(fā)員都有機(jī)會(huì)討論,你需要核心隊(duì)伍來(lái)創(chuàng)建支持規(guī)則的工具,讓文件組建更水到渠成。核心成員也可以花些時(shí)間思考尋找好文件結(jié)構(gòu),來(lái)服務(wù)于團(tuán)隊(duì)組織或工作模式。

圖源:unsplash

當(dāng)開(kāi)發(fā)員明白在哪加文件、以什么樣的方式可以加速開(kāi)發(fā)、讓自己在代碼庫(kù)的工作環(huán)境中更加自在時(shí),世界就會(huì)變得不同。

SwiftLint、Danger、本地腳本這些工具都會(huì)助你一臂之力。但有一點(diǎn)需要提醒,那就是首先你需要明白工具在何處有用,這通常需要?jiǎng)觿?dòng)手指。

使用工具,共同參與,像解決其他對(duì)公司不利的問(wèn)題一樣處理它。這是一件超值的事情,會(huì)讓大家更輕松地找到或添加文件,幫助開(kāi)發(fā)員理解編碼庫(kù)的架構(gòu)模式。

幸福是什么?是井井有條的代碼庫(kù),是全體成員的思考和智慧,是體驗(yàn)感與學(xué)習(xí)的共贏。這就是幸福呀!

網(wǎng)頁(yè)名稱:井井有條的代碼庫(kù),才是工作中最大的幸福
文章位置:http://jinyejixie.com/news/100695.html

成都網(wǎng)站建設(shè)公司_創(chuàng)新互聯(lián),為您提供軟件開(kāi)發(fā)靜態(tài)網(wǎng)站、微信小程序、關(guān)鍵詞優(yōu)化、Google、自適應(yīng)網(wǎng)站

廣告

聲明:本網(wǎng)站發(fā)布的內(nèi)容(圖片、視頻和文字)以用戶投稿、用戶轉(zhuǎn)載內(nèi)容為主,如果涉及侵權(quán)請(qǐng)盡快告知,我們將會(huì)在第一時(shí)間刪除。文章觀點(diǎn)不代表本網(wǎng)站立場(chǎng),如需處理請(qǐng)聯(lián)系客服。電話:028-86922220;郵箱:631063699@qq.com。內(nèi)容未經(jīng)允許不得轉(zhuǎn)載,或轉(zhuǎn)載時(shí)需注明來(lái)源: 創(chuàng)新互聯(lián)

網(wǎng)站托管運(yùn)營(yíng)
新乡市| 临颍县| 洞口县| 左权县| 福泉市| 蒙山县| 淮北市| 阿瓦提县| 德保县| 松滋市| 博爱县| 古田县| 上犹县| 望奎县| 五寨县| 莎车县| 和田县| 甘南县| 吴川市| 贡觉县| 南投市| 河北省| 吉首市| 垦利县| 砚山县| 花莲市| 潞西市| 长乐市| 双城市| 犍为县| 巨鹿县| 苍南县| 喀喇沁旗| 巴南区| 名山县| 水城县| 娄底市| 大洼县| 荔波县| 卢湾区| 铜梁县|