Git-də Develop Branch — bu nədir, məqsədi və iş prinsipi

Git-də Develop Branch nədir

Develop Branch (inkişaf budağı) — Git Flow-da uzunömürlü budaqdır, bütün tərtibatçıların kodunun inteqrasiyası üçün mərkəzi node rolunu oynayır. İnkişaf başa çatdıqdan və code review-dən keçdikdən sonra feature budaqları bura birləşdirilir.

Develop-dakı kod həmişə release yaratmağa hazır vəziyyətdədir, baxmayaraq ki, hələ istehsalata buraxılmamışdır. Bu o deməkdir ki, develop-dakı bütün funksiyalar review, test və inteqrasiya yoxlamalarından keçmişdir, lakin hələ də release dövrünü gözləyir.

Main-dən fərqli olaraq, hər kod versiyasının release olduğu yerdə, develop davamlı dəyişiklik axınını ehtiva edir. Develop-da commitlər feature budaqlarının birləşdirilməsi ilə ortaya çıxır, bu da gündə bir neçə dəfə baş verə bilər.

Vincent Driessen, 2010 məlumatlarına görə, develop uğurlu branching modelinin əsas elementidir, çünki o, qaralama işi buraxılışa hazır versiyalardan ayırır.

Develop və main branch arasındakı fərqlər

Develop və main arasındakı fərqləri başa düşmək Git Flow-da düzgün iş üçün kritik əhəmiyyət daşıyır. Bu budaqlar müxtəlif funksiyaları yerinə yetirir və sabitlik üçün müxtəlif tələblərə malikdir.

Develop və main-ə bölünmə komandaya davamlı olaraq yeni kodu inteqrasiya etməyə imkan verir, istehsal versiyasının sabitliyini riskə atmadan. Tərtibatçılar öz kodlarını develop-də PR təsdiqləndikdən dərhal sonra, hətta rəsmi release-dən əvvəl görə bilərlər.

Develop-in Git Flow-da rolu

Git Flow modelində develop feature budaqları (dəyişiklik mənbəyi) və release budaqları (buraxılışa hazırlıq) arasında mərkəzi yer tutur. Bu iyerarxiyanı başa düşmək effektiv budaqlanmanın əsasıdır.

• Feature → Develop — hər bir tamamlanmış funksiya Pull Request ilə code review-dən keçərək develop-a birləşdirilir.
• Develop → Release — release üçün kifayət qədər dəyişiklik toplandıqda, develop-dan release budağı yaradılır.
• Release → Main + Develop — yekun hazırlıqdan sonra release budağı main-ə (release) və geri develop-a (bugfix) birləşdirilir.
• Hotfix → Main + Develop — kritik düzəlişlər main-dən yaradılır və hər iki budağa birləşdirilir.

Belə bir struktur develop-in həmişə bütün yeni funksiyalarla ən son kod versiyasını, main-in isə yalnız yoxlanılmış istehsal kodunu ehtiva etməsini təmin edir. Bu, App Store və Google Play-də uzun review dövrü olan mobil layihələr üçün xüsusilə vacibdir.

Develop-in Git Flow-un digər budaqları ilə əlaqəsi

Develop feature, release və hotfix budaqları arasında mərkəzi halqa rolunu oynayır. Birləşdirmə istiqamətlərini başa düşmək konfliktlərin və commit itkisinin qarşısını almaq üçün əsasdır.

Develop-da kod keyfiyyətinə tələblər

Kod keyfiyyəti develop-da yüksək, lakin mütləq olmamalıdır. Main-dən fərqli olaraq, hər səhvin təcili hotfix demək olduğu yerdə, develop release-dən əvvəl düzəldiləcək kiçik çatışmazlıqlara yol verir.

Develop-a birləşdirmədən əvvəl kod üçün minimal tələblər:

• Kompilyasiya — kod səhvsiz kompilyasiya olunmalıdır. Develop-da qırılan kompilyasiya bütün komandanın işini bloklayır.
• Vahid testləri — bütün mövcud testlər keçməlidir. Yeni kod minimum 70% test əhatəsinə malik olmalıdır.
• Code style — kod komandada qəbul edilmiş formatlama və adlandırma standartlarına uyğun olmalıdır.
• Köhnəlmiş API-lərin olmaması — yeni kodda köhnəlmiş metodlardan istifadəyə icazə verilmir.

CI/CD pipeline-da avtomatik yoxlamalar develop-a hər push-da işə düşməlidir. Əgər kompilyasiya pozulursa, məsul tərtibatçı problemi bir saat ərzində düzəltməli və ya öz commitini geri qaytarmalıdır.

Develop üçün CI/CD yoxlamaları

GitHub Actions-un develop üçün konfiqurasiyası hər PR-nin birləşdirmədən əvvəl avtomatik yoxlamadan keçməsini təmin edir. Tipik pipeline kompilyasiya, testlər və linting daxildir.

# GitHub Actions — birləşdirmədən sonra develop-ı yoxlama
name: Develop CI

on:
  pull_request:
    branches: [develop]

jobs:
  validate:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - name: Unit tests
        run: ./gradlew testDebug
      - name: Lint
        run: ./gradlew lint
      - name: Build
        run: ./gradlew assembleDebug

Develop-a birləşdirmə qaydaları

Develop-a birləşdirmə inteqrasiya budağının sabitliyini qorumaq üçün ciddi qaydalara tabe olmalıdır. Bu qaydaların pozulması konfliktlərə, qırılan kompilyasiyalara və komanda vaxtının itkisinə səbəb olur.

• Yalnız Pull Request vasitəsilə — develop-a birbaşa push qadağandır. Bütün dəyişikliklər code review-dən keçir.
• Minimum bir approve — PR tapşırıqda iştirak etməyən ən azı bir tərtibatçı tərəfindən təsdiqlənməlidir.
• Squash merge — təmiz tarix üçün develop-a birləşdirərkən feature budağının bütün commitlərini birinə birləşdirmək tövsiyə olunur.
• PR-nin aktual olması — birləşdirmədən əvvəl PR develop-in son commit-inə nisbətən yenilənməlidir (rebase və ya merge).

PR-nin aktual olması qaydası xüsusilə vacibdir. Əgər feature budağı bir həftə əvvəl yaradılıbsa və develop 50 commit irəlidədirsə, birbaşa birləşdirmə develop-da deyil, PR kontekstində həll etmək daha yaxşı olan konfliktlərə səbəb ola bilər.

Develop-ı səhv birləşdirmələrdən qoruma

Branch protection rules (budaq qoruma qaydaları) — GitHub, GitLab və ya Bitbucket səviyyəsində develop-da səhv dəyişikliklərin qarşısını alan parametrlərdir. Onlar hətta təsadüfi push-un inteqrasiya budağını sındırmamasını təmin edir.

Develop üçün tövsiyə olunan qoruma qaydaları:

• Require pull request — develop-a birbaşa push-u qadağan et. Bütün dəyişikliklər yalnız PR vasitəsilə.
• Require approvals — PR birləşdirməsindən əvvəl minimum 1-2 təsdiq.
• Require status checks — CI/CD pipeline keçməzsə, birləşdirməni blokla.
• Require up-to-date — PR budağı birləşdirmədən əvvəl develop-a nisbətən yenilənməlidir.
• Restrict push access — develop-a push hüququnu yalnız senior tərtibatçılar üçün məhdudlaşdır.

Develop qorunmasını konfiqurasiya etmək 10 dəqiqə çəkir, lakin qırılan inteqrasiya budağı ilə bağlı həftələrlə dayanmanın qarşısını alır. Çoxplatformalı komandaları olan mobil layihələr üçün bu xüsusilə aktualdır.

Develop ilə işləmək üçün əmr nümunələri

Tipik bir tərtibatçı gününü nəzərdən keçirək: səhər develop-ı yeniləyir, yeni feature budağı yaradır və tapşırığı bitirdikdən sonra dəyişiklikləri develop-a geri birləşdirir.

# Səhər develop sinxronizasiyası
git checkout develop
git pull origin develop

# Develop-dan yeni feature budağı yaratma
git checkout -b feature/add-push-notifications

# Funksiya üzərində iş...
git add . && git commit -m "Add FCM integration"

# İnkişaf zamanı develop-ı yeniləmə
git fetch origin develop
git rebase origin/develop

# PR təsdiqləndikdən sonra — lokal develop-ı yeniləmə
git checkout develop
git pull origin develop
git branch -d feature/add-push-notifications

Develop-da git pull əmri eyni anda iki əməliyyatı yerinə yetirir: git fetch (serverdən yeni commitləri gətirir) və git merge (onları lokal budaqla birləşdirir). Develop üçün bu, sinxronizasiyanın standart üsuludur.

Qırılan birləşdirmədən sonra develop-ı bərpa etmək

Əgər develop-a kompilyasiyanı sındıran kod daxil olubsa, tez hərəkət etmək lazımdır. Develop-in hər saat dayanması bütün tərtibatçı komandasının bloklanmış işi deməkdir.

Əgər develop-a kompilyasiyanı sındıran kod daxil olubsa, problemli dəyişiklikləri ləğv edən yeni commit yaratmaq üçün git revert istifadə edin. Develop-da git reset istifadə etməyin — bu, digər iştirakçılarda artıq mövcud olan tarixi yenidən yazır.

# Problemli commit-in axtarışı
git log --oneline develop

# Commit-i revert vasitəsilə ləğv etmə (təhlükəsiz)
git revert a1b2c3d

# Düzəlişin uzaq develop-a göndərilməsi
git push origin develop

# Müəyyən commit-də dəyişikliklərə baxış
git show a1b2c3d --stat