Jak vytvořit požadavky na pull: kroky a pokyny pro začátečníky

Pull request je důležitý nástroj pro práci s Git a GitHub. Umožňuje navrhnout změny v projektu jiným vývojářům a učinit z nich součást hlavního kódu. Pull request zahrnuje vytvoření samostatné větve, provádění změn, jejich testování a požadavek na začlenění těchto změn do hlavní větve projektu.

Kroky k vytvoření požadavky na pull jsou následující:

1. Nejprve musíte přejít na stránku projektu na Githubu a kliknout na tlačítko "Fork" (umístěné v pravém horním rohu). To umožní vytvořit kopii projektu ve svém osobním úložišti.
2. Dále je nutné naklonovat kopii projektu do místního počítače pomocí příkazu git clone.
3. Poté je třeba vytvořit novou větev, která provede změny. Chcete-li to provést , použijte příkaz git checkout - b, kde je název nové větve.
4. Nyní je možné provést potřebné změny kódu, přidat nové funkce nebo opravit chyby.
5. Když jsou provedeny všechny změny, musíte je přidat do commitu pomocí příkazu git add pro všechny změněné soubory a poté příkazu git commit-m "popis provedených změn".
6. Poté byste měli nahrát své změny na server GitHub pomocí příkazu git push origin, kde je název vaší větve.
7. Nakonec na stránce úložiště na Githubu uvidíte tlačítko "compare & pull request". Kliknutím na něj přejdete k vytvoření požadavku na pull, kde můžete popsat a odeslat své změny.

Je důležité si uvědomit, že před vytvořením požadavku na pull se doporučuje aktualizovat kopii projektu na nejnovější verzi hlavní větve, aby se předešlo konfliktům sloučení.

Tímto způsobem budete moci postupovat podle těchto kroků a navrhnout změny v projektu. Je to skvělá příležitost podílet se na vývoji a získat zpětnou vazbu od ostatních vývojářů.

Vytvořte Fork projektu

Chcete-li vytvořit Fork projektu, musíte přejít na stránku projektu na Githubu a kliknout na tlačítko s nápisem "Fork", které se nachází v pravém horním rohu stránky. Poté bude projekt zkopírován do vašeho účtu.

Jakmile vytvoříte Fork, můžete naklonit úložiště na místní stroj pomocí příkazu git clone . Nyní můžete provést změny v projektu lokálně.

Mějte na paměti, že Fork je samostatné úložiště a všechny vaše změny provedené ve forku nebudou mít vliv na původní projekt, dokud nevytvoříte a nepošlete požadavek na pull.

Nyní, když máte na svém počítači Fork projektu a místní kopii, jste připraveni vytvořit a odeslat požadavek na pull, abyste provedli své změny v původním projektu.

Klonujte svůj Fork lokálně

Než začnete pracovat na aplikaci pull request, musíte naklonovat svůj Fork úložiště na vašem místním počítači.

Chcete-li to provést, postupujte podle následujících kroků:

1. Přejděte na stránku vašeho Fork úložiště na Githubu.
2. Klikněte na tlačítko "Clone or download" a zkopírujte adresu URL vašeho forku.
3. Otevřete příkazový řádek nebo terminál v počítači.
4. Přejděte do složky, kde chcete uložit místní kopii úložiště.
5. Zadejte příkaz "git clone" a vložte zkopírovanou adresu URL vašeho forku.
6. Stisknutím klávesy Enter spustíte klonování.

Nyní máte místní kopii vašeho forku úložiště, se kterou můžete pracovat na svém požadavku na pull.

Vytvořte novou větev

Než začnete pracovat na nové funkci nebo úpravě kódu, musíte ve svém úložišti vytvořit novou větev. Vlákno vám umožňuje izolovat vaši práci od hlavního kódu, abyste se vyhnuli konfliktům a zachovali její integritu.

Chcete-li vytvořit novou větev, přejděte na stránku úložiště na Githubu. V horní části úložiště uvidíte rozbalovací seznam, ve kterém vyberte větev, ze které chcete vytvořit novou. Poté zadejte název větve do příslušného pole a klikněte na tlačítko "Vytvořit novou větev".

Důležitě: Pojmenujte větve smysluplně a srozumitelně, aby ostatní vývojáři snadno pochopili, o čem je řeč a sledovali vaši práci.

Jakmile vytvoříte novou větev, můžete na ni přepnout a začít dělat svou práci. Uložte své změny v této větvi a proveďte komity, abyste zaznamenali průběžné výsledky. Jakmile dokončíte svou práci, budete moci vytvořit požadavek na pull, aby byly vaše změny provedeny v hlavní větvi úložiště.

Proveďte potřebné změny

Před odesláním pull request je nutné provést požadované změny v kódu projektu. Proto:

1. Skloňte úložiště do počítače pomocí příkazu git clone .

2. Vytvořte novou větev, která bude obsahovat změny pro požadavky na pull. Název větve je lepší zvolit s popisným a srozumitelným názvem, jako je fix-bug-123 .

3. Proveďte potřebné změny v kódu projektu. Může to být oprava chyb, přidání nové funkce nebo jakékoli jiné změny v rámci úkolu, který máte před sebou.

4. Ujistěte se, že váš kód odpovídá stylu a formátování přijatému v projektu. Aby nedošlo k problémům se slučováním, doporučujeme zkontrolovat váš kód, zda nedošlo ke konfliktům s jinými větvemi.

5. Jakmile jsou všechny změny provedeny a zkontrolovány, zapište změny do vzdáleného úložiště pomocí příkazu git push .

Nyní můžete vytvořit požadavek na pull na platformě, která hostuje vaše úložiště. Uveďte název a popis změn, které jste provedli, aby ostatní vývojáři jasně pochopili podstatu vašeho požadavku na sloučení změn. Po vytvoření pull request počkejte, až bude zkontrolován a osazen hlavní větví projektu.

Zakomponujte a zapište změny do svého forku

Jakmile provedete potřebné změny v kódu projektu, dalším krokem je tyto změny zakomponovat a zapustit do vašeho forku. To vám umožní vytvořit historii změn, kterou budete používat při vytváření požadavků na pull.

1. Otevřete terminál nebo příkazový řádek ve své místní složce projektu.
2. Přidejte změny do commitu pomocí příkazu git add . . Tento příkaz přidá všechny změněné soubory a nové soubory do commit.
3. Změňte změny pomocí příkazu git commit-m "popis vašich změn". Nezapomeňte přidat popis, který jasně a stručně vysvětluje, co bylo ve vašem kódu změněno nebo přidáno.
4. Změňte svůj Fork pomocí příkazu git push origin branch-name . Nahraďte název větve, do které chcete změny zapustit.

Po dokončení těchto kroků budou vaše změny uloženy ve vašem Fork projektu. Nyní můžete vytvořit požadavek na pull, abyste provedli své změny v hlavní větvi projektu.