Mündəricat:

Açıq Mənbə Təchizatı üçün Versiya Nəzarəti: 10 Addım
Açıq Mənbə Təchizatı üçün Versiya Nəzarəti: 10 Addım

Video: Açıq Mənbə Təchizatı üçün Versiya Nəzarəti: 10 Addım

Video: Açıq Mənbə Təchizatı üçün Versiya Nəzarəti: 10 Addım
Video: ZƏMANƏ UŞAĞI 2024, Noyabr
Anonim
Açıq Mənbə Təchizatı üçün Versiya Nəzarəti
Açıq Mənbə Təchizatı üçün Versiya Nəzarəti

Brainbow komandasının kəmərlərimiz altında bir çox elektronika layihəsi var və biz elektronika dizayn iş akışımızı idarə etmək üçün versiya nəzarətindən istifadə prosesimizi bölüşmək istədik. Bu iş axını, sadə 2 qat lövhədən kompleks 10 qat behemotlara qədər böyük və kiçik layihələr üçün istifadə edilmişdir və açıq mənbə vasitələrinə əsaslanır. Ümid edirik ki, başqaları iş akışımızı özləri üçün qəbul edə və öz layihələri üçün versiya nəzarətinin faydalarını əldə edə bilərlər. Bəs versiya nəzarəti bir elektronika layihəsi təklif edə bilərmi?

Addım 1: Niyə Versiya Elektroninizi Nəzarət Edir?

Version Control (aka source control və ya revision control) proqram mühəndisliyində yaxşı başa düşülmüş və geniş qəbul edilmiş bir anlayışdır. Mənbə nəzarətinin ideyası, bir proqramın və ya tətbiqin mənbə kodunda edilən dəyişiklikləri sistematik olaraq izləməkdir. Dəyişikliklər tətbiqi pozarsa, mənbə kodu fayllarını keçmişdən məlum bir iş vəziyyətinə qaytara bilərsiniz. Təcrübədə, mənbə idarəetmə sistemləri bir fayl toplusunun tarixini izləməyə imkan verir (adətən kompüter proqramı, veb sayt və s. Üçün mənbə kodu faylları) və bu sənədlərdəki dəyişiklikləri görselleştirmek və idarə etmək.

Bir layihədəki dəyişikliklərin tarixini izləmək elektronika layihələri üçün faydalı görünür; sxem sxemində bir səhv etsəniz və ya PCB planında səhv komponent izini istifadə etsəniz, bir layihənin müxtəlif versiyalarında hansı səhvlərin edildiyini və hansı düzəlişlərin tətbiq olunduğunu izləmək yaxşı olardı. Bu tarixi görmək və müxtəlif dəyişikliklərin kontekstini və motivlərini başa düşmək digər istehsalçılar üçün də faydalı olardı.

Addım 2: Alətlər: KiCad və Git

Alətlər: KiCad və Git
Alətlər: KiCad və Git

Bu layihədə iki əsas vasitədən istifadə edirik: versiya idarəetmə sistemi (VCS) və elektron dizayn avtomatlaşdırma proqramı (EDA və ya ECAD).

Orada bir çox versiya idarəetmə sistemi var, ancaq paylanmış VCS Git -dən istifadə edirik. Bir neçə səbəbdən istifadə edirik, amma əsas odur ki, açıq mənbəlidir (yoxlayın!), İstifadəsi asandır (yoxlayın!) Və açıq mənbəli proqram təminatı üçün faktiki olaraq standart VCS (yoxlayın!). ECAD proqramımızın istifadə etdiyi fayllardakı dəyişiklikləri izləmək üçün Git'i VCS olaraq istifadə edəcəyik. Bu Təlimatlandırmanın Git ilə tanışlığı tələb olunmur, lakin komanda xəttindən istifadə edərək ümumi rahatlıq nəzərdə tutulur. Lazım gələrsə həm Git, həm də əmr satırının istifadəsi üçün faydalı mənbələrə keçid etməyə çalışacağam.

Əksər mənbə idarəetmə sistemləri mətn əsaslı fayllar üçün xüsusilə yaxşı işləyir, buna görə mətn fayllarından istifadə edən bir ECAD proqramı əla olardı. CERN tədqiqatçıları tərəfindən dəstəklənən açıq mənbəli "Çarpaz Platforma və Açıq Mənbə Elektronika Dizaynı Avtomatlaşdırma Paketi" olan KiCad-a daxil olun. KiCad eyni zamanda açıq mənbəyidir (yoxlayın!), İstifadəsi asandır (bəziləri mənimlə razılaşmasa da) və qabaqcıl elektronika dizayn işləri üçün yüksək qabiliyyətə malikdir.

Addım 3: Quraşdırma

Quraşdırma
Quraşdırma
Quraşdırma
Quraşdırma

Bu proqramları quraşdırmaq üçün aşağıda göstərilən müxtəlif yükləmə saytlarından gələn təlimatları izləyin.

  • KiCad çarpaz platformadır (və başgicəlləndirici şəkildə belədir; onların yükləmə səhifəsi dəstəklənən 13 OS-ni siyahıya alır və onlardan heç biri sizə uyğun gəlmirsə mənbə kodu yükləməyi təklif edir). Gecə inkişaf etdirmə quruluşunu deyil, kicad-unified default quraşdırmasını istifadə edin. Kitabxana quraşdırılması ilə bağlı qabaqcıl əlavə məlumat üçün Addım 4 -ə baxın.
  • Git də çarpaz platformadır. Windows istifadə edirsinizsə, daha faydalı və tam xüsusiyyətli bir təcrübə üçün təsirli Windows üçün Git layihəsini tövsiyə edərdim.

Hər iki saytda mövcud olan quraşdırma sənədləri burada təqdim edə biləcəyim hər hansı bir təsvirdən daha tam olacaqdır. Hər iki proqram endirildikdən və quraşdırıldıqdan sonra Github depomuzdan Brainbow layihə şablonunu klonlaya bilərsiniz. Git clone əmri `git clone {src directory} {target directory} 'quruluşunu alır; layihəmiz üçün `git clone https://github.com/builtbybrainbow/kicad-starter.git {target directory} 'istifadə edin.

Git reponun klonlanması xüsusi bir kopyalama formasıdır; bir layihəni klonladığınızda, repoya daxil olan bütün faylların bir kopyasını və layihənin bütün Git-izlənmiş tarixini alırsınız. Repomuzu klonlaşdırmaqla, Git -in KiCad ilə istifadəsinə dair tövsiyələrimizlə artıq qurulmuş bir layihə kataloqunu əldə edirsiniz. 6 -cı addımda layihə quruluşu haqqında daha çox məlumat verəcəyik və ya işə başlamaq üçün qaşınırsınızsa 7 -ci addıma keçə bilərsiniz.

Bir neçə sürətli ev təmizliyi vəzifəsi - klonladığınız Github layihəsinə olan əlaqəni silmək üçün `git remote rm mənşəyini 'işlədin. Ayrıca, müəllif parametrini adınız və e -poçtunuzla əvəz edərək `git commit --amend --author =" John Doe "" işləyin. Bu, sonuncu öhdəliyi düzəldir (bu halda həm də birinci öhdəlikdir) və müəllifi Brainbow -dan daha çox sizə dəyişdirir.

Addım 4: Quraşdırma Qeyd: KiCad Kitabxanaları

Quraşdırma Qeyd: KiCad Kitabxanaları
Quraşdırma Qeyd: KiCad Kitabxanaları

KiCad -ın kitabxana quruluşu haqqında qısa bir qeyd. KiCad, geniş bir elektrik komponentləri üçün geliştirici qrupu tərəfindən saxlanılan bir çox kitabxana təmin edir. Üç əsas kitabxana var:

  • Şematik Nişanlar: Elektron komponentləri sxematik sxemdə təmsil etmək üçün istifadə olunan simvollar.
  • PCB Ayaq İzi: Bir PCB üzərində dövrə qoyarkən istifadə ediləcək faktiki ayaq izini (mis yastıqlar, ipək ekran mətni və s.) Əks etdirən 2D təsvirlər.
  • 3D Modellər: Elektron komponentlərin 3D modelləri.

Bu kitabxanalar yeni qurduğunuz KiCad proqram paketi ilə birlikdə endirilir. KiCad -ı heç bir səy göstərmədən istifadə edə bilərsiniz. Bununla birlikdə, "güclü istifadəçilər" üçün, kitabxanalar üçün mənbə faylları Github -da bir git deposunda saxlanılır, bu da ən son dəyişikliklərdən xəbərdar olmaq istəyən istifadəçilərə kitabxana repolarını öz maşınlarına klonlaşdırmağa imkan verir. Kitabxanaları git ilə izləməyin bir sıra üstünlükləri var - kitabxanalarınızı nə vaxt yeniləmək istədiyinizi seçə bilərsiniz və yeniləmələr bütün kitabxana faylları dəstini yenidən yükləmək əvəzinə yalnız sənədlərə dəyişikliklər daxil etməyi tələb edir. Ancaq unutmaq asan ola biləcək kitabxanaların yenilənməsindən məsuldur.

Kitabxanaları klonlaşdırmaq istəyirsinizsə, bu sayt müxtəlif Github repo KiCad təkliflərini ətraflı şəkildə izah edir. Kitabxanaları kompüterinizə klonlayın (məsələn: `git clone https:// github.com/KiCad/kicad-symbols.git`), sonra KiCad-ı açın, menyu çubuğundan" Tercihlər "maddəsini seçin və" Yolları Konfiqurasiya et … "düyməsini basın. ". Bu, KiCad -a hər bir kitabxananı axtarmaq üçün kataloq yolunu söyləməyinizə imkan verir. Bu mühit dəyişənləri, KiCad quraşdırılması ilə quraşdırılmış kitabxanaların yolunu təyin edir; Lazım gələrsə yenidən standart kitabxanalara keçə bilmək üçün bu dəyərləri qeyd etdim. KICAD_SYMBOL_DIR yolu klonlaşdırılmış kicad-simvol kitabxananızı, KISYSMOD-ı klonlanmış ayaq izləri kitabxanasını və KISYS3DMOD-ı klonlanmış kicad-packages3d kitabxanasını göstərməlidir.

Kitabxanaları yeniləmək istədiyiniz zaman, kitabxananın repo hissəsində Git -ə kitabxananın yerli repo ilə Github "uzaqdan" repo arasındakı fərqləri yoxlamağı və avtomatik olaraq yeniləməyinizi bildirəcək sadə bir "git pull" əmrini işlədə bilərsiniz. dəyişiklikləri daxil etmək üçün yerli nüsxə.

Addım 5: Git əsasları

Git əsasları
Git əsasları

Git, bütün kitabları mənimsəməyə həsr olunmuş kompleks və çoxşaxəli bir proqramdır. Bununla birlikdə, iş akışımızda Git'i necə istifadə etdiyimizi anlamanıza kömək edəcək bir neçə sadə anlayış var.

Git, bir sıra mərhələlərdən istifadə edərək sənədlərdəki dəyişiklikləri izləyir. İşçi qovluğunda normal dəyişikliklər baş verir. Bir sıra fayllarda etdiyiniz dəyişikliklərdən razı qaldığınız zaman, dəyişdirdiyiniz faylları hazırlama sahəsinə əlavə edirsiniz. Planlaşdırdığınız bütün dəyişiklikləri etdikdən və Git -də izləmək istədiyiniz bütün faylları səhnələşdirdikdən sonra bu dəyişiklikləri depoya köçürürsünüz. Tapşırıqlar, mahiyyətcə müəyyən bir zamanda bir repodakı faylların vəziyyətinin anlarıdır. Git fayllardakı dəyişiklikləri izlədiyi və bu dəyişiklikləri öhdəliklərdə saxladığı üçün, istənilən vaxt bir layihəni əvvəlki hər hansı bir öhdəlikdə olduğu vəziyyətə qaytara bilərsiniz.

Dallanma və uzaqdan idarəetmə kimi daha mürəkkəb mövzular var, ancaq mənbə nəzarətinin faydalarını əldə etmək üçün bunları istifadə etməyimizə ehtiyac yoxdur. Bizə lazım olan tək şey, KiCad dizayn sənədlərimizdəki dəyişiklikləri bir sıra öhdəliklər ilə izləməkdir.

Addım 6: KiCad Layihə Quruluşu

KiCad Layihə Quruluşu
KiCad Layihə Quruluşu

Daha əvvəl klonladığınız KiCad-Starter layihəsinin quruluşuna daha yaxından nəzər salaq. Asanlıqla təşkil etmək üçün bir neçə alt qovluğa bölünür:

  • Dövrə: Bu qovluqda faktiki KiCad layihə faylları (sxematik, PCB və s.) Var. Mən bu qovluğun adını dəyişmirəm, amma içindəki bütün faylları layihənin adı ilə adlandırıram (Circuit.pro => ArduinoMini.pro).

    • Circuit.pro: KiCad layihə faylı
    • Circuit.sch: KiCad sxematik faylı.
    • Circuit.kicad_pcb: KiCad PCB layout faylı.
  • Sənədlər: Bu qovluq layihə ilə bağlı sənədlərin saxlanması üçündür. Gələcəkdə bu məkanı yaxşılaşdırmaq üçün planlarımız var, amma hazırda sadə bir README faylını ehtiva edir. Gələcəkdə nəzərdən keçirməyiniz üçün layihə haqqında qeydlər saxlamaq üçün istifadə edin.
  • İstehsal: Bu qovluq, əksər fab evlərinin elektron kartınızı istehsal etmək üçün istifadə edəcəyi gerber fayllarını saxlayacağınız yerdir. İstehsal və montaj üçün lazım ola biləcək BOM sənədlərini və digər sənədləri saxlamaq üçün də istifadə edirik.
  • Kitabxanalar: Bu qovluq, layihəyə xas olan kitabxana fayllarını saxlamaq üçündür (bunu bir neçə addımda daha ətraflı izah edəcəyik).

Başqa bir neçə faylı da müşahidə edə bilərsiniz (xüsusən də kataloqa ls -a` etsəniz).. Git qovluğu, Git'in anbar tarixçəsini saxlayaraq sehr etdiyi yerdir.. Gitignore faylı, Git -ə hansı faylları görməməli olduğunu və mənbə nəzarətində saxlamamasını söyləmək üçün istifadə olunur. Bunlar əsasən KiCad -ın yaratdığı ehtiyat sənədlər və ya şəbəkə siyahıları kimi bir neçə fərqli "yaradılan" sənədlərdir və onlar sxematik fayl olan mənbədən yarandıqları üçün mənbə nəzarətində saxlanılmamalıdır.

Bu layihə quruluşu yalnız bir başlanğıc nöqtəsidir. Ehtiyaclarınıza uyğun olaraq uyğunlaşdırmalı və lazım olduqda bölmələr əlavə etməlisiniz. Bəzi layihələrdə, layihə üçün 3d çap korpusları üçün modelləri saxladığımız bir proqram qovluğunu və ya əlavə qovluğunu daxil etdik.

Addım 7: KiCad Layihələri üçün Git istifadə edin

KiCad Layihələri üçün Git -dən istifadə
KiCad Layihələri üçün Git -dən istifadə
KiCad Layihələri üçün Git -dən istifadə
KiCad Layihələri üçün Git -dən istifadə
KiCad Layihələri üçün Git -dən istifadə
KiCad Layihələri üçün Git -dən istifadə

Layihələrinizi izləmək üçün Git -dən necə istifadə edəcəyinizi görməyə hazırıq. Bu Təlimat sizə KiCad -ı necə istifadə etməyi öyrətmək üçün nəzərdə tutulmayıb (baxmayaraq ki, tələbat olduqda gələcəkdə bunu edə bilərəm), buna görə də iş axınının necə işlədiyini göstərmək üçün bəzi əhəmiyyətsiz nümunələrdən keçəcəyik. Bu fikirlərin real bir layihəyə necə uyğunlaşdırılacağını anlamaq asan olmalıdır.

Kicad-starter qovluğunu açın, sonra tarixini göstərmək üçün `git log`unu işlədin. Burada bir öhdəlik olmalıdır, Brainbow tərəfindən reponun başlanğıcı. Git statusunu işə salmaq, repo sənədlərinizin vəziyyətini (izlənilməmiş, dəyişdirilmiş, silinmiş, mərhələli) sizə xəbər verəcəkdir.

Hal -hazırda repolarınızda heç bir dəyişiklik olmamalıdır. Gəlin bir dəyişiklik edək. KiCad layihəsini açın və sxemə bir rezistor əlavə edin, sonra qeyd edin. İndi 'git statusu' işləyərkən, sxematik faylı dəyişdirdiyinizi göstərməlisiniz, ancaq bu dəyişiklikləri hələ yerinə yetirmək üçün hazırlamamısınız. Rezistoru əlavə edərkən KiCad -ın tam olaraq nə etdiyini bilmək istəyirsinizsə, diff əmrini dəyişdirilmiş 'git diff Circuit/Circuit.sch` faylında işlədə bilərsiniz. Bu, iş qovluğundakı faylın cari versiyası ilə son işdəki faylın vəziyyəti arasındakı dəyişiklikləri vurğulayacaqdır.

Bir dəyişiklik etdikdən sonra, gəlin bu dəyişikliyi layihə tariximizə bağlamağa çalışaq. Dəyişiklikləri iş kataloqumuzdan hazırlama sahəsinə köçürməliyik. Bu, əslində fayl sistemindəki faylları hərəkətə gətirmir, ancaq konseptual olaraq Git -ə müəyyən bir fayl üçün bütün planlı dəyişikliklər etdiyinizi və bu dəyişiklikləri etməyə hazır olduğunuzu bildirməyin bir yoludur. Git, növbəti hərəkət üçün `git status`unu işlədərkən bəzi göstərişlər verir. "Ediləcəkləri yeniləmək üçün" git add… "istifadə edin) mesajına diqqət yetirin. Git, dəyişiklikləri quruluş sahəsinə necə köçürməyinizi sizə izah edir. Dəyişiklikləri yerinə yetirmək üçün "git add Circuit/Circuit.sch" düyməsini, sonra baş verənləri görmək üçün "git status" düyməsini basın. İndi dəyişdiriləcək dəyişikliklərin altında olan sxematik faylı görürük. Hələ bu dəyişiklikləri etmək istəmirsinizsə, Git köməkçi olaraq başqa bir ipucu təklif edir: `(səhnədən çıxarmaq üçün" git reset HEAD … "istifadə edin). Bu dəyişiklikləri yerinə yetirmək istəyirik, buna görə də "git amal -m" sxeminə rezistor əlavə edildi "'ni işə salırıq. Bu, verilən mesajla dəyişiklikləri yerinə yetirir. Git günlüyü işlətmək, bu öhdəliyi layihə öhdəlik tarixində göstərəcək.

Öhdəliklər haqqında daha bir neçə məsləhət.

  1. Hər qənaətlə bağlı olmayın. Dəyişikliklərinizin bir qədər möhkəmləndiyi bir nöqtəyə çatdığınızı hiss etdiyiniz zaman qərar verin. Hər bir komponent əlavə edildikdən sonra deyil, sxematik işi bitirdikdən sonra söz verirəm. Həm də çox nadir hallarda etmək istəmirsiniz, çünki 3 həftə sonra etdiyiniz dəyişiklikləri niyə etdiyiniz kontekstini xatırlamaq çətin ola bilər. Nə vaxt öhdəlik götürməyinizi anlamaq bir az sənətdir, ancaq Git -dən daha çox istifadə etdikcə özünüzü daha rahat hiss edəcəksiniz.
  2. Yalnız mağaza mənbəyi (əsasən). Bura layihə, sxematik və layout faylları, həmçinin layihəyə xas kitabxanalar daxildir. Bura sənəd sənədləri də daxil ola bilər. Alınan obyektləri saxlayarkən diqqətli olun, çünki onlar orijinal mənbə ilə sinxronizasiyadan asanlıqla çıxa bilər və bu da sonradan baş ağrısına səbəb olur. BOM və gerber faylları xüsusilə asanlıqla sinxronizasiya olunur, buna görə də daha yaxşı qarşısı alınır (daha ətraflı təlimat Adım 9-da verilsə də).
  3. Commit mesajları çox faydalıdır, amma yaxşı qurulmuş mesajlar əvəzolunmazdır. Bu əla məqalə aydın, qısa, faydalı öhdəlik mesajları yazmaq üçün bəzi qaydalar təqdim edir. Bunu etmək üçün yeni başlayanlar üçün mürəkkəbləşdirə biləcəyim bir əmr satırı mətn redaktorunun istifadəsi tələb oluna bilər (-m mesajı seçimi olmadan `git əmri` bir mətn redaktoru açacaq). Əksər insanlar üçün Nano redaktorunu məsləhət görürəm. StackOverflow, redaktorunuzu dəyişdirmək üçün yaxşı bir izahat verir

Addım 8: Qabaqcıl: Elektronikanın Semantik Versiyası

Ətraflı: Elektronika üçün semantik versiya
Ətraflı: Elektronika üçün semantik versiya

Sərgüzəştli ruhlar üçün aşağıdakı ipuçları, KiCad -ın çoxsaylı inkişafından əldə edilən qabaqcıl fikirlərdir. Kiçik layihələrdə xüsusilə faydalı olmasalar da, layihələriniz mürəkkəbləşdikcə sizi ürək ağrısından xilas edə bilərlər.

Proqram təminatında Semantik Versiya (semver) anlayışı var. Semver, "Major. Minor. Patch" nümunəsinə uyğun olaraq proqram buraxılışlarını "versiya nömrəsi" ilə müəyyən etmək üçün ümumi bir adlandırma metodologiyası təyin edir. Semverin spesifikasiyasından sitat gətirmək üçün versiya nömrəsini aşağıdakı dəyişiklik kateqoriyalarına uyğun olaraq irəli sürürsünüz.

  1. Uyğun olmayan API dəyişiklikləri etdikdə MAJOR versiyası,
  2. Əməliyyat funksiyasını geriyə uyğun bir şəkildə əlavə etdiyiniz zaman MINOR versiyası,
  3. PATCH versiyası geriyə uyğun gələn səhv düzəlişləri etdikdə.

Brainbow olaraq, hardware layihələrinin ehtiyaclarına uyğunlaşdırılmış öz semver versiyamızı istifadə edirik. Xüsusiyyətlərimiz eyni "Major. Minor. Patch" modelini izləyir, baxmayaraq ki, hansı dəyişikliklərin hansı kateqoriyaya aid olduğu ilə bağlı təriflərimiz açıq şəkildə fərqlənir.

  1. MAJOR versiyası: dövrənin əsas funksionallığında əhəmiyyətli dəyişikliklər üçün istifadə olunur (məsələn: ATmegaa'dan ESP8266 -ya keçmə prosessoru).
  2. Kiçik versiya: dövrə işinə təsir edə biləcək komponent dəyişdirmələri üçün istifadə olunur (məsələn: fərqli bir əmr dəstinə malik ola bilən pinlə uyğun olan SPI flaş dəyişdirmə) və ya bəzi əlavə xüsusiyyətlərin əlavə edilməsi (məsələn: əlavə temperatur sensoru əlavə edildi).
  3. PATCH versiyası: dövrə işini dəyişdirməyəcək kiçik səhvləri düzəltmək üçün istifadə olunur (məsələn: ipək ekran tənzimlənməsi, kiçik iz düzeni tənzimlənməsi, 0603 kondansatörü kimi 0805 -ə qədər sadə komponent dəyişdirmə).

Donanım semverində versiya nömrəsi yalnız istehsalda yenilənir (proqramda olduğu kimi, versiya nömrələri də yalnız buraxılışlarla dəyişir, hər bir şəxs bir layihəyə bağlı deyil). Nəticədə, bir çox layihənin aşağı versiya sayı var. Hələ bir layihəmizin 4 -dən çox əsas versiyasını istifadə etməmişik.

Yaxşı müəyyən edilmiş bir adlandırma sisteminə keçiddən əldə etdiyiniz ardıcıllıq və anlaşıqlılıqdan başqa, firmware uyğunluğu və müştəri məmnuniyyəti baxımından da faydalanırsınız. Firmware, təyin etdiyi lövhənin versiyasını nəzərə alaraq yazıla bilər və müəyyən bir proqramın müəyyən bir lövhədə işləməməsinin səbəbini düzəltmək daha asan ola bilər ("sağda, 2.4.1 firmware 1.2 -də işləmir) lövhələr, çünki bizdə yoxdur … "). Müştərilər, hardware semverimizdən də faydalandılar, çünki müştəri xidməti və problemlərin aradan qaldırılması müəyyən bir standartla daha asandır.

Addım 9: Qabaqcıl: Avadanlıq Semantik Versiyasından istifadə

Ətraflı: Hardware Semantic Versioning istifadə
Ətraflı: Hardware Semantic Versioning istifadə

Öz layihələrinizdə hardware semverindən istifadə etmək üçün etiketləmə adlı bir Git xüsusiyyətindən istifadə edirik. Bir lövhə ilk istehsal etdiyiniz zaman bu lövhənin 1.0.0 versiyasıdır. Layihənizdəki bütün dəyişiklikləri etdiyinizə əmin olun, sonra `git tag -a v1.0.0` işləyin. Bu etiket üçün bir annotasiya mesajı yaza biləcəyiniz üçün bir redaktor açacaq (öhdəlik mesajına çox bənzəyir). İstehsalat (PCB -ni kim hazırladı, lövhəni kim yığdı) haqqında təfərrüatları əlavə edirəm ki, bu da sonradan faydalı ola bilər.

Buraxılış etiketi öhdəlik tarixinə əlavə olunur və 1.0.0 istehsalında faylların vəziyyətini göstərir. Problemlərin aradan qaldırılması üçün bu nöqtəyə yenidən müraciət etməyiniz lazım gəldikdə, bu, bir neçə düzəlişdən sonra daha faydalı ola bilər. Göstərilən buraxılış etiketi olmadan, istehsal zamanı ən son hansı öhdəliyin alındığını anlamaq çətin ola bilər. 1.0.0 (və 1.1, 1.1.1 və s.) Etiketi, bu xüsusi mənbə fayllarının müəyyən bir istehsal işində istifadə edildiyini təyin etməyə imkan verir.

Gerbers haqqında bir qeyd. Bəzi fab evləri lövhənizi hazırlamaq üçün gerber faylları tələb edir və bunları KiCad ilə yarada bilərsiniz. Bunlar mənbə.kicad_pcb faylından yaranan törəmə obyektlərdir və biz ümumiyyətlə törəmə fayllara versiya nəzarət etmirik. Biz Brainbow -da, buraxılışın etiketlənməsi zamanı istisna olmaqla versiya nəzarətində gerbers saxlamırıq. Qurmağa hazır olduğumuzda, gerber fayllarını yaradırıq, onları Fabrikasiya qovluğunda saxlayırıq və öhdəlik götürürük və etiketləyirik. Sonra gerberləri çıxarırıq və silməni həyata keçiririk. Bu əvvəlcə bir az qarışıq görünə bilər, ancaq normal işlərin yalnız mənbə fayllarını saxlamasını təmin edir və etiketli buraxılışlar da lövhələrin istehsalı üçün istifadə olunan faylları saxlayır. Bu, bir neçə həftə sonra istehsal səhvlərinin izlənilməsində olduqca faydalı olduğunu sübut etdi.

Addım 10: Növbəti addımlar

Ümid edirik ki, bu giriş sizə öz elektron layihələrinizdə versiya nəzarətindən istifadə etməyə başlamağı öyrətdi. Layihələr və ya xüsusiyyət şöbələri arasında paylaşılan kitabxanalar üçün versiya nəzarəti kimi daha inkişaf etmiş mövzulardan bəzilərini əldə edə bilmədik. Yenə də versiya nəzarəti tərəvəzlərinizi yemək kimidir: düşündüyünüzü ala bilməyəcəksiniz, ancaq aldığınız hər şey sayılır.

Brainbow, iş prosesimizin bəzi daha inkişaf etmiş xüsusiyyətlərinə dair daha ətraflı bir bələdçi üzərində işləyir. Növbəti bir neçə ayda bir dəfə dərc edəcəyimizi ümid edirik. Təlimatlarda bizi burada izləyin və oxuya biləcəyiniz zaman sizə xəbər verəcəyimizdən əmin olacağıq.

Oxuduğunuz üçün təşəkkür edirik və nə etdiyinizi görmək üçün səbirsizliklə gözləyirik!

Tövsiyə: