Dolibarr ERP CRM Wiki - User contributions [en]

Module Time Tracker

2023-07-07T11:46:18Z

Speaking services: Note added

{{TemplateDocDevEn}}
{{TemplateDocUser}}
=Informations=
{{TemplateModuleInfo
|modulename=Time Tracker
|webbuy=https://www.dolistore.com/en/modules/1875-Time-Tracker.html
|editor=[[Speaking Services]]
|web=http://2geeks.me
|status=stable
|minversion=15.0.0
|note=First publication 2023
}}

=Features=
This module allows to track the time spent on working for a specific customer and to facilitate the billing process for the corresponding services. The main focus of this TimeTracking module is not only to measure the time spent on a specific service, but also to save time in the administration and billing of that service.

=Install=
{{InstallModuleEn}}

=Setup=
{{ActivationModuleEn}}

Module Time Tracker

2023-07-07T11:43:51Z

Speaking services: Purchase Link updated

{{TemplateDocDevEn}}
{{TemplateDocUser}}
=Informations=
{{TemplateModuleInfo
|modulename=Time Tracker
|webbuy=https://www.dolistore.com/en/modules/1875-Time-Tracker.html
|editor=[[Speaking Services]]
|web=http://2geeks.me
|status=stable
|minversion=15.0.0
}}

=Features=
This module allows to track the time spent on working for a specific customer and to facilitate the billing process for the corresponding services. The main focus of this TimeTracking module is not only to measure the time spent on a specific service, but also to save time in the administration and billing of that service.

=Install=
{{InstallModuleEn}}

=Setup=
{{ActivationModuleEn}}

Module Time Tracker

2023-07-07T11:37:46Z

Speaking services: Purchase Link updated

[[Category:Complementary modules]]
[[Category:TimeTracker]]
{{TemplateDocDevEn}}
{{TemplateDocUser}}
=Informations=
{{TemplateModuleInfo
|modulename=Time Tracker
|webbuy={{LinkToPluginDownloadDoliStore}}/en/modules/1875-Time-Tracker.html
|editor=[[Speaking Services]]
|web=http://2geeks.me
|status=stable
|minversion=15.0.0
}}

=Features=
This module allows to track the time spent on working for a specific customer and to facilitate the billing process for the corresponding services. The main focus of this TimeTracking module is not only to measure the time spent on a specific service, but also to save time in the administration and billing of that service.

=Install=
{{InstallModuleEn}}

=Setup=
{{ActivationModuleEn}}

Module Time Tracker

2023-07-07T11:35:30Z

Speaking services: Header update

[[Category:Complementary modules]]
[[Category:TimeTracker]]
{{TemplateDocDevEn}}
{{TemplateDocUser}}
=Informations=
{{TemplateModuleInfo
|modulename=Time Tracker
|webbuy={{LinkToPluginDownloadDoliStore}}
|editor=[[Speaking Services]]
|web=http://2geeks.me
|status=stable
|minversion=15.0.0
}}

=Features=
This module allows to track the time spent on working for a specific customer and to facilitate the billing process for the corresponding services. The main focus of this TimeTracking module is not only to measure the time spent on a specific service, but also to save time in the administration and billing of that service.

=Install=
{{InstallModuleEn}}

=Setup=
{{ActivationModuleEn}}

Module Time Tracker

2023-07-07T11:24:02Z

Speaking services: Update of header information

[[Category:Complementary modules]]
[[Category:TimeTracker]]
{{TemplateDocDevEn}}
{{TemplateDocUser}}
= Informations =
{{TemplateModuleInfo
|editor=[[Speaking Services]]
|web=http://2geeks.me
|status=stable
|minversion=2.6.0
|note=}}

= Features =
This module allows to track the time spent on working for a specific customer and to facilitate the billing process for the corresponding services. The main focus of this TimeTracking module is not only to measure the time spent on a specific service, but also to save time in the administration and billing of that service.

= Install =
{{InstallModuleEn}}

= Setup =
{{ActivationModuleEn}}

[[Category:Complementary Modules]]

Module Time Tracker

2023-07-07T11:20:53Z

Speaking services: Header included

[[Category:Complementary modules]]
[[Category:TimeTracker]]
{{TemplateDocDevEn}}
{{TemplateDocUser}}
= Informations =
{{TemplateModuleInfo}}

= Features =
SpeedFinder adds a menu to quick search for a contact or a company by entering a few digits of the phone.

= Install =
{{InstallModuleEn}}

= Setup =
{{ActivationModuleEn}}

[[Category:Complementary Modules]]

Module Time Tracker

2023-07-07T11:15:26Z

Speaking services: Templates included

{{TemplateDocDevEn}}{{TemplateDocUser}}

To be described
[[Category:Complementary Modules]]

Module Time Tracker

2023-07-07T11:12:31Z

Speaking services:

To be described
[[Category:Complementary Modules]]

Module Time Tracker

2023-07-07T09:39:40Z

Speaking services: Description of the Time Tracker Module

To be described
[[Category:Modules complémentaires]]

Modul Barcode

2022-09-25T08:28:04Z

Speaking services:

[[en:Module_Barcode]]
[[fr:Module_Codes_Barre]]
[[es:Módulo_Código_de_barra]]


[[Category:Barcode]]
{{TemplateDocUser}}
{{TemplateModEN Developer}}
{{BasculeDevUserEn|
name=Barcode|
num=55|
devdoc=[[Modul Barcode (developer)]]|
userdoc=This page}}

= Einleitung =
Diese Modul ermöglicht die Verwendung von Barcodes in Dolibarr (z.B. zum Druck in Belegen).

= Installation =
{{NoInstallModuleDE}}

= Konfiguration =
{{ActivationModuleDE}}

==Barcode-Kodierungstyp==
Auf der Einstellungs-Seite wählen Sie für jedes Barcodeformat, das Sie unterstützen möchten, die Engine, die die grafische Ausgabe (Bild) des Barcodes erstellt.

Die standardmäßig verfügbaren und von den Dolibarr-Entwicklern unterstützten Engines sind die Dolibarr-interne Engine auf Basis von '''php-barcode''' und TCPDF-barcode, die den in der TCPDF-Bibliothek verfügbaren Barcode-Generator nutzt.

Bei Bedarf können Sie das Programm genbarcode (http://www.ashberg.de/php-barcode/download/#genbarcode) installieren, um weitere von dieser Engine unterstützte Formate zu erhalten. Die Quellen für das Kommandozeilenprogramm '''genbarcode''' sind auch hier verfügbar: [[Datei:Genbarcode-0.4.tar.gz]]

Sie können auch neue Barcode-Generator-Engines installieren (siehe im Downloadbereich von http://www.dolibarr.org), um weitere Formate zu unterstützen.

==Weitere Optionen==
Wählen Sie dann auf der Seite für die Moduleinrichtung stets aus, welche Funktion Sie mit Barcodes erweitern möchten:

*Verwaltung der Produkte
*Verwaltung der Partner

==Manager zur automatischen Definition von Barcode-Nummern (Produkt)==
Aktivieren Sie das Nummerierungsmodul, das Sie zum Vorschlagen und Validieren von Barcode-Nummern für Produkte verwenden möchten. Definieren Sie auch eine Maske, damit die automatische Nummerierung funktioniert.

Wenn Sie z. B. bei der vorherigen Einrichtung das EAN-Format ( http://en.wikipedia.org/wiki/International_Article_Number_(EAN) ) für Produkte gewählt haben, können Sie den Wert auf folgende Weise eingeben:
<syntaxHighlight lang="ini">
300999{000000}
</syntaxHighlight>

*Dabei ist 300 die Landesnummer (siehe http://www.gs1.org/barcodes/support/prefix_list)
*999 ist die Unternehmensnummer (je nach Land kann sie mehr Ziffern haben). Um eine Nummer für Ihr Unternehmen zu erhalten, müssen Sie sich an die GS1 für Ihr Land wenden: http://www.gs1.org/contact
*{000000} ist die Produktnummer. Sie bestimmen diese Nummer. Sie ist ein Zähler mit maximal 6 Ziffern (je nach Land kann sie weniger Ziffern haben). Die Länge beträgt (8 - Anzahl der Ziffern für Ihre Firmennummer).
*Die Prüfsummenziffer ist für EAN13 nicht erforderlich (sie wird automatisch hinzugefügt).

Hinweis: Ein EAN13-Strichcode identifiziert in den meisten Fällen ein Produkt (als Vorlage), ebenso wie die Referenz eines Produkts (auch '''Teilenummer''' genannt). Die Identifizierung der Serie oder eines Postens kann mit der '''Seriennummer''', auch '''SSN''', '''S/N''', oder '''SN''' genannt, oder der '''Produktnummer''' erfolgen. Serien- und Produktnummer sind manchmal eine eigenständige Strichcodenummer, manchmal in einem EAN128-Code enthalten: http://www.barcodeisland.com/uccean128.phtml. Eine Seriennummer kann ein Posten oder eine einmalige Instanz eines Produkts sein (d.h. ein Posten von 1).

Hinweis: Die '''SKU''' ist ein allgemeiner Begriff, um zu sagen: "Die ID ist genau genug, um den Bestand zu verwalten". SKU hängt also davon ab, ob Sie einen Posten verwenden oder nicht. Es kann eine '''Teilenummer''' oder eine '''Seriennummer''' sein. Am besten ist es, diesen Begriff nicht zu verwenden, um Verwirrung zu vermeiden.

=Verwendung=
Sobald der Einrichtungsschritt abgeschlossen ist, sehen Sie auf einigen Bildschirmen ein neues Feld "Barcode", je nachdem, was Sie für die zu erweiternden Funktionen ausgewählt haben (Seiten für Partner und/oder Produkt-Seiten).
In diese Felder können Sie dann Barcodewerte über die Tastatur oder einen Barcodescanner eingeben:

==Verwendung der Tastatur==
Geben Sie einfach die im Barcode dargestellte Nummer ein. Dies setzt voraus, dass diese Nummer unter der Barcode-Grafik gedruckt wurde. Dies ist der Fall, wenn Sie den Barcode-Sticker mit der Funktion "'<nowiki/>'''''Print barcode''''''" drucken, die mit Dolibarr 3.6+ (Menü '''Tools''') bereitgestellt wird.

==Verwendung eines Barcode-Scanners==
Wenn der Barcode nicht sichtbar ist oder wenn Sie keine Zeit mit dem Eintippen der Zahlen verlieren wollen, können Sie einen Hardware-Barcodescanner verwenden. Um mit Dolibarr kompatibel zu sein, muss Ihr Barcodescanner die "Tastatur-Emulation" unterstützen: Wenn Sie den Barcode scannen, ist es so, als würden Sie die Zahl auf der Tastatur eingeben.
Um einen Barcode-Scanner zu finden, der diese Emulation unterstützt, müssen Sie einen Blick auf die technische Spezifikation werfen. Der Scanner muss den Begriff unterstützen:

* "HID" Modus (für Human Interface Device)

oder

*"Keyboard Wedge" oder "Wedge" Schnittstelle

Weitere Informationen auf der Seite: http://www.taltech.com/barcodesoftware/articles/which_barcode_scanner_interface

Es gibt Barcodeleser, die den Barcode EAN13 (13 Zahlen) lesen, und andere, die den Barcode Code-39 (numerisch, unbegrenzte Anzahl von Zeichen) oder den Barcode Code-128 (Alphabet, unbegrenzte Anzahl von Zeichen) lesen. Die meisten Barcode-Scanner lesen alle Formate.

*EAN13 wird verwendet, um ein Produkt zu definieren.
*Code-39 wird für die Bestandsverfolgung verwendet (Seriennummer nur mit numerischen Zeichen).
*Code-128 wird für die Lagerbestandsverfolgung verwendet (Seriennummer mit numerischen und alphanumerischen Zeichen).

Um zu testen, ob Ihr Scanner den Code-128 lesen kann, können Sie diese Seite verwenden (drucken Sie sie vorher aus, da die meisten Scanner nicht funktionieren, wenn sie direkt auf dem Computerbildschirm verwendet werden):
http://www.softmatic.com/faq-2-7.html

Beispiele:

*MOTOROla DS4208
*Datalogic QW2120
*EAN: 6913280798816

Dies ist ein weiteres Beispiel, das erfolgreich unter Linux Ubuntu getestet wurde:

*http://www.amazon.de/gp/product/B008RG3EG6
*Schließen Sie einfach das USB-Kabel des Scanners an Ihren Computer an und scannen Sie dann den Barcode auf dem mitgelieferten Handbuch, um die richtige Tastatur einzustellen. Sobald dies geschehen ist, wird jeder Scan so ausgegeben, als ob Sie die Tastatur verwenden.

Modul Barcode

2022-09-25T08:18:10Z

Speaking services:

[[en:Module_Barcode]]
[[fr:Module_Codes_Barre]]
[[es:Módulo_Código_de_barra]]


[[Category:Barcode]]
{{TemplateDocUser}}
{{TemplateModEN Developer}}
{{BasculeDevUserEn|
name=Barcode|
num=55|
devdoc=[[Modul Barcode (developer)]]|
userdoc=This page}}

= Einleitung =
Diese Modul ermöglicht die Verwendung von Barcodes in Dolibarr (z.B. zum Druck in Belegen).

= Installation =
{{NoInstallModuleDE}}

= Konfiguration =
{{ActivationModuleDE}}

==Barcode-Kodierungstyp==
Auf der Einstellungs-Seite wählen Sie für jedes Barcodeformat, das Sie unterstützen möchten, die Engine, die die grafische Ausgabe (Bild) des Barcodes erstellt.

Die standardmäßig verfügbaren und von den Dolibarr-Entwicklern unterstützten Engines sind die Dolibarr-interne Engine auf Basis von '''php-barcode''' und TCPDF-barcode, die den in der TCPDF-Bibliothek verfügbaren Barcode-Generator nutzt.

Bei Bedarf können Sie das Programm genbarcode (http://www.ashberg.de/php-barcode/download/#genbarcode) installieren, um weitere von dieser Engine unterstützte Formate zu erhalten. Die Quellen für das Kommandozeilenprogramm '''genbarcode''' sind auch hier verfügbar: [[Datei:Genbarcode-0.4.tar.gz]]

Sie können auch neue Barcode-Generator-Engines installieren (siehe im Downloadbereich von http://www.dolibarr.org), um weitere Formate zu unterstützen.

==Weitere Optionen==
Wählen Sie dann auf der Seite für die Moduleinrichtung stets aus, welche Funktion Sie mit Barcodes erweitern möchten:

*Verwaltung der Produkte
*Verwaltung der Partner

==Manager zur automatischen Definition von Barcode-Nummern (Produkt)==
Aktivieren Sie das Nummerierungsmodul, das Sie zum Vorschlagen und Validieren von Barcode-Nummern für Produkte verwenden möchten. Definieren Sie auch eine Maske, damit die automatische Nummerierung funktioniert.

Wenn Sie z. B. bei der vorherigen Einrichtung das EAN-Format ( http://en.wikipedia.org/wiki/International_Article_Number_(EAN) ) für Produkte gewählt haben, können Sie den Wert auf folgende Weise eingeben:
<syntaxHighlight lang="ini">
300999{000000}
</syntaxHighlight>

*Dabei ist 300 die Landesnummer (siehe http://www.gs1.org/barcodes/support/prefix_list)
*999 ist die Unternehmensnummer (je nach Land kann sie mehr Ziffern haben). Um eine Nummer für Ihr Unternehmen zu erhalten, müssen Sie sich an die GS1 für Ihr Land wenden: http://www.gs1.org/contact
*{000000} ist die Produktnummer. Sie bestimmen diese Nummer. Sie ist ein Zähler mit maximal 6 Ziffern (je nach Land kann sie weniger Ziffern haben). Die Länge beträgt (8 - Anzahl der Ziffern für Ihre Firmennummer).
*Die Prüfsummenziffer ist für EAN13 nicht erforderlich (sie wird automatisch hinzugefügt).

Hinweis: Ein EAN13-Strichcode identifiziert in den meisten Fällen ein Produkt (als Vorlage), ebenso wie die Referenz eines Produkts (auch '''Teilenummer''' genannt). Die Identifizierung der Serie oder eines Postens kann mit der '''Seriennummer''', auch '''SSN''', '''S/N''', oder '''SN''' genannt, oder der '''Produktnummer''' erfolgen. Serien- und Produktnummer sind manchmal eine eigenständige Strichcodenummer, manchmal in einem EAN128-Code enthalten: http://www.barcodeisland.com/uccean128.phtml. Eine Seriennummer kann ein Posten oder eine einmalige Instanz eines Produkts sein (d.h. ein Posten von 1).

Hinweis: Die '''SKU''' ist ein allgemeiner Begriff, um zu sagen: "Die ID ist genau genug, um den Bestand zu verwalten". SKU hängt also davon ab, ob Sie einen Posten verwenden oder nicht. Es kann eine '''Teilenummer''' oder eine '''Seriennummer''' sein. Am besten ist es, diesen Begriff nicht zu verwenden, um Verwirrung zu vermeiden.

=Verwendung=
Sobald der Einrichtungsschritt abgeschlossen ist, sehen Sie auf einigen Bildschirmen ein neues Feld "Barcode", je nachdem, was Sie für die zu erweiternden Funktionen ausgewählt haben (Seiten für Partner und/oder Produkt-Seiten).
In diese Felder können Sie dann Barcodewerte über die Tastatur oder einen Barcodescanner eingeben:

==Verwendung der Tastatur==
Geben Sie einfach die im Barcode dargestellte Nummer ein. Dies setzt voraus, dass diese Nummer unter der Barcode-Grafik gedruckt wurde. Dies ist der Fall, wenn Sie den Barcode-Sticker mit der Funktion "'<nowiki/>'''''Print barcode''''''" drucken, die mit Dolibarr 3.6+ (Menü '''Tools''') bereitgestellt wird.

==Verwendung eines Barcode-Scanners==
Wenn der Barcode nicht sichtbar ist oder wenn Sie keine Zeit mit dem Eintippen der Zahlen verlieren wollen, können Sie einen Hardware-Barcodescanner verwenden. Um mit Dolibarr kompatibel zu sein, muss Ihr Barcodescanner die "Tastatur-Emulation" unterstützen: Wenn Sie den Barcode scannen, ist es so, als würden Sie die Zahl auf der Tastatur eingeben.
Um einen Barcode-Scanner zu finden, der diese Emulation unterstützt, müssen Sie einen Blick auf die technische Spezifikation werfen. Der Scanner muss den Begriff unterstützen:

* "HID" Modus (für Human Interface Device)

oder

*"Keyboard Wedge" oder "Wedge" Schnittstelle

Weitere Informationen auf der Seite: http://www.taltech.com/barcodesoftware/articles/which_barcode_scanner_interface

Es gibt Barcodeleser, die den Barcode EAN13 (13 Zahlen) lesen, und andere, die den Barcode Code-39 (numerisch, unbegrenzte Anzahl von Zeichen) oder den Barcode Code-128 (Alphabet, unbegrenzte Anzahl von Zeichen) lesen. Die meisten Barcode-Scanner lesen alle Formate.

*EAN13 wird verwendet, um ein Produkt zu definieren.
*Code-39 wird für die Bestandsverfolgung verwendet (Seriennummer nur mit numerischen Zeichen).
*Code-128 wird für die Lagerbestandsverfolgung verwendet (Seriennummer mit numerischen und alphanumerischen Zeichen).

Um zu testen, ob Ihr Scanner den Code-128 lesen kann, können Sie diese Seite verwenden (drucken Sie sie vorher aus, da die meisten Scanner nicht funktionieren, wenn sie direkt auf dem Computerbildschirm verwendet werden):
http://www.softmatic.com/faq-2-7.html

Beispiele:

*MOTOROla DS4208
*Datalogic QW2120
*EAN: 6913280798816

Dies ist ein weiteres Beispiel, das erfolgreich unter Linux Ubuntu getestet wurde:

*http://www.amazon.fr/gp/product/B008RG3EG6
*Schließen Sie einfach das USB-Kabel des Scanners an Ihren Computer an und scannen Sie dann den Barcode auf dem mitgelieferten Handbuch, um die richtige Tastatur einzustellen. Sobald dies geschehen ist, wird jeder Scan so ausgegeben, als ob Sie die Tastatur verwenden.

Modul Barcode

2022-09-25T08:16:56Z

Speaking services:

[[en:Module_Barcode]]
[[fr:Module_Codes_Barre]]
[[es:Módulo_Código_de_barra]]


[[Category:Barcode]]
{{TemplateDocUser}}
{{TemplateModDE Developer}}
{{BasculeDevUserDe|
name=Barcode|
num=55|
devdoc=[[Modul Barcode (developer)]]|
userdoc=This page}}

= Einleitung =
Diese Modul ermöglicht die Verwendung von Barcodes in Dolibarr (z.B. zum Druck in Belegen).

= Installation =
{{NoInstallModuleDE}}

= Konfiguration =
{{ActivationModuleDE}}

==Barcode-Kodierungstyp==
Auf der Einstellungs-Seite wählen Sie für jedes Barcodeformat, das Sie unterstützen möchten, die Engine, die die grafische Ausgabe (Bild) des Barcodes erstellt.

Die standardmäßig verfügbaren und von den Dolibarr-Entwicklern unterstützten Engines sind die Dolibarr-interne Engine auf Basis von '''php-barcode''' und TCPDF-barcode, die den in der TCPDF-Bibliothek verfügbaren Barcode-Generator nutzt.

Bei Bedarf können Sie das Programm genbarcode (http://www.ashberg.de/php-barcode/download/#genbarcode) installieren, um weitere von dieser Engine unterstützte Formate zu erhalten. Die Quellen für das Kommandozeilenprogramm '''genbarcode''' sind auch hier verfügbar: [[Datei:Genbarcode-0.4.tar.gz]]

Sie können auch neue Barcode-Generator-Engines installieren (siehe im Downloadbereich von http://www.dolibarr.org), um weitere Formate zu unterstützen.

==Weitere Optionen==
Wählen Sie dann auf der Seite für die Moduleinrichtung stets aus, welche Funktion Sie mit Barcodes erweitern möchten:

*Verwaltung der Produkte
*Verwaltung der Partner

==Manager zur automatischen Definition von Barcode-Nummern (Produkt)==
Aktivieren Sie das Nummerierungsmodul, das Sie zum Vorschlagen und Validieren von Barcode-Nummern für Produkte verwenden möchten. Definieren Sie auch eine Maske, damit die automatische Nummerierung funktioniert.

Wenn Sie z. B. bei der vorherigen Einrichtung das EAN-Format ( http://en.wikipedia.org/wiki/International_Article_Number_(EAN) ) für Produkte gewählt haben, können Sie den Wert auf folgende Weise eingeben:
<syntaxHighlight lang="ini">
300999{000000}
</syntaxHighlight>

*Dabei ist 300 die Landesnummer (siehe http://www.gs1.org/barcodes/support/prefix_list)
*999 ist die Unternehmensnummer (je nach Land kann sie mehr Ziffern haben). Um eine Nummer für Ihr Unternehmen zu erhalten, müssen Sie sich an die GS1 für Ihr Land wenden: http://www.gs1.org/contact
*{000000} ist die Produktnummer. Sie bestimmen diese Nummer. Sie ist ein Zähler mit maximal 6 Ziffern (je nach Land kann sie weniger Ziffern haben). Die Länge beträgt (8 - Anzahl der Ziffern für Ihre Firmennummer).
*Die Prüfsummenziffer ist für EAN13 nicht erforderlich (sie wird automatisch hinzugefügt).

Hinweis: Ein EAN13-Strichcode identifiziert in den meisten Fällen ein Produkt (als Vorlage), ebenso wie die Referenz eines Produkts (auch '''Teilenummer''' genannt). Die Identifizierung der Serie oder eines Postens kann mit der '''Seriennummer''', auch '''SSN''', '''S/N''', oder '''SN''' genannt, oder der '''Produktnummer''' erfolgen. Serien- und Produktnummer sind manchmal eine eigenständige Strichcodenummer, manchmal in einem EAN128-Code enthalten: http://www.barcodeisland.com/uccean128.phtml. Eine Seriennummer kann ein Posten oder eine einmalige Instanz eines Produkts sein (d.h. ein Posten von 1).

Hinweis: Die '''SKU''' ist ein allgemeiner Begriff, um zu sagen: "Die ID ist genau genug, um den Bestand zu verwalten". SKU hängt also davon ab, ob Sie einen Posten verwenden oder nicht. Es kann eine '''Teilenummer''' oder eine '''Seriennummer''' sein. Am besten ist es, diesen Begriff nicht zu verwenden, um Verwirrung zu vermeiden.

=Verwendung=
Sobald der Einrichtungsschritt abgeschlossen ist, sehen Sie auf einigen Bildschirmen ein neues Feld "Barcode", je nachdem, was Sie für die zu erweiternden Funktionen ausgewählt haben (Seiten für Partner und/oder Produkt-Seiten).
In diese Felder können Sie dann Barcodewerte über die Tastatur oder einen Barcodescanner eingeben:

==Verwendung der Tastatur==
Geben Sie einfach die im Barcode dargestellte Nummer ein. Dies setzt voraus, dass diese Nummer unter der Barcode-Grafik gedruckt wurde. Dies ist der Fall, wenn Sie den Barcode-Sticker mit der Funktion "'<nowiki/>'''''Print barcode''''''" drucken, die mit Dolibarr 3.6+ (Menü '''Tools''') bereitgestellt wird.

==Verwendung eines Barcode-Scanners==
Wenn der Barcode nicht sichtbar ist oder wenn Sie keine Zeit mit dem Eintippen der Zahlen verlieren wollen, können Sie einen Hardware-Barcodescanner verwenden. Um mit Dolibarr kompatibel zu sein, muss Ihr Barcodescanner die "Tastatur-Emulation" unterstützen: Wenn Sie den Barcode scannen, ist es so, als würden Sie die Zahl auf der Tastatur eingeben.
Um einen Barcode-Scanner zu finden, der diese Emulation unterstützt, müssen Sie einen Blick auf die technische Spezifikation werfen. Der Scanner muss den Begriff unterstützen:

* "HID" Modus (für Human Interface Device)

oder

*"Keyboard Wedge" oder "Wedge" Schnittstelle

Weitere Informationen auf der Seite: http://www.taltech.com/barcodesoftware/articles/which_barcode_scanner_interface

Es gibt Barcodeleser, die den Barcode EAN13 (13 Zahlen) lesen, und andere, die den Barcode Code-39 (numerisch, unbegrenzte Anzahl von Zeichen) oder den Barcode Code-128 (Alphabet, unbegrenzte Anzahl von Zeichen) lesen. Die meisten Barcode-Scanner lesen alle Formate.

*EAN13 wird verwendet, um ein Produkt zu definieren.
*Code-39 wird für die Bestandsverfolgung verwendet (Seriennummer nur mit numerischen Zeichen).
*Code-128 wird für die Lagerbestandsverfolgung verwendet (Seriennummer mit numerischen und alphanumerischen Zeichen).

Um zu testen, ob Ihr Scanner den Code-128 lesen kann, können Sie diese Seite verwenden (drucken Sie sie vorher aus, da die meisten Scanner nicht funktionieren, wenn sie direkt auf dem Computerbildschirm verwendet werden):
http://www.softmatic.com/faq-2-7.html

Beispiele:

*MOTOROla DS4208
*Datalogic QW2120
*EAN: 6913280798816

Dies ist ein weiteres Beispiel, das erfolgreich unter Linux Ubuntu getestet wurde:

*http://www.amazon.fr/gp/product/B008RG3EG6
*Schließen Sie einfach das USB-Kabel des Scanners an Ihren Computer an und scannen Sie dann den Barcode auf dem mitgelieferten Handbuch, um die richtige Tastatur einzustellen. Sobald dies geschehen ist, wird jeder Scan so ausgegeben, als ob Sie die Tastatur verwenden.

Modul Barcode

2022-09-25T07:58:02Z

Speaking services:

[[en:Module_Barcode]]
[[fr:Module_Codes_Barre]]
[[es:Módulo_Código_de_barra]]


[[Category:Barcode]]
{{TemplateDocUser}}
{{TemplateModDE Developer}}
{{BasculeDevUserDe|
name=Barcode|
num=55|
devdoc=[[Modul Barcode (developer)]]|
userdoc=This page}}

= Einleitung =
Diese Modul ermöglicht die Verwendung von Barcodes in Dolibarr (z.B. zum Druck in Belegen).

= Installation =
{{NoInstallModuleDE}}

= Konfiguration =
{{ActivationModuleDE}}

==Barcode-Kodierungstyp==
Auf der Einstellungs-Seite wählen Sie für jedes Barcodeformat, das Sie unterstützen möchten, die Engine, die die grafische Ausgabe (Bild) des Barcodes erstellt.

Die standardmäßig verfügbaren und von den Dolibarr-Entwicklern unterstützten Engines sind die Dolibarr-interne Engine auf Basis von '''php-barcode''' und TCPDF-barcode, die den in der TCPDF-Bibliothek verfügbaren Barcode-Generator nutzt.

Bei Bedarf können Sie das Programm genbarcode (http://www.ashberg.de/php-barcode/download/#genbarcode) installieren, um weitere von dieser Engine unterstützte Formate zu erhalten. Die Quellen für das Kommandozeilenprogramm '''genbarcode''' sind auch hier verfügbar: [[Datei:Genbarcode-0.4.tar.gz]]

Sie können auch neue Barcode-Generator-Engines installieren (siehe im Downloadbereich von http://www.dolibarr.org), um weitere Formate zu unterstützen.

==Weitere Optionen==
Wählen Sie dann auf der Seite für die Moduleinrichtung stets aus, welche Funktion Sie mit Barcodes erweitern möchten:

*Verwaltung der Produkte
*Verwaltung der Partner

==Manager zur automatischen Definition von Barcode-Nummern (Produkt)==
Aktivieren Sie das Nummerierungsmodul, das Sie zum Vorschlagen und Validieren von Barcode-Nummern für Produkte verwenden möchten. Definieren Sie auch eine Maske, damit die automatische Nummerierung funktioniert.

Wenn Sie z. B. bei der vorherigen Einrichtung das EAN-Format ( http://en.wikipedia.org/wiki/International_Article_Number_(EAN) ) für Produkte gewählt haben, können Sie den Wert auf folgende Weise eingeben:
<syntaxHighlight lang="ini">
300999{000000}
</syntaxHighlight>

*Dabei ist 300 die Landesnummer (siehe http://www.gs1.org/barcodes/support/prefix_list)
*999 ist die Unternehmensnummer (je nach Land kann sie mehr Ziffern haben). Um eine Nummer für Ihr Unternehmen zu erhalten, müssen Sie sich an die GS1 für Ihr Land wenden: http://www.gs1.org/contact
*{000000} ist die Produktnummer. Sie bestimmen diese Nummer. Sie ist ein Zähler mit maximal 6 Ziffern (je nach Land kann sie weniger Ziffern haben). Die Länge beträgt (8 - Anzahl der Ziffern für Ihre Firmennummer).
*Die Prüfsummenziffer ist für EAN13 nicht erforderlich (sie wird automatisch hinzugefügt).

Note: A barcode EAN13 identify in most cases a product (as a template), like do the reference of a product (also called '''Part number'''). Identification of the serial or lot can be done with the '''Serial No''' also called '''SSN''', '''S/N''', or '''SN''' or the '''Product No'''. Serial and Product are sometimes an autonomous bar code number, sometimes included into a EAN128 code: http://www.barcodeisland.com/uccean128.phtml. A serial may be a lot or a unique instance of a product (that is a lot of 1).

Note: The '''SKU''' is a generic term to say: "The ID enough accurate to manage stock". So SKU depends if you use lot or not. It can be a '''Part number''' or a '''Serial No'''. Best thing is to avoid using this term to avoid confusion.

=Usage=
Once the setup step is finished, you will see a new field "bar code" on some screens, depending on what you choosed for features to enhance (third party screen and/or product screen).
You can then enter barcode values in such fields, using keyboard or barcode scanner:
==Using keyboard==
Just enter the number represented into the barcode. This suppose that number was printed under barcode graphic. This will be the case if you print the barcode stickker using the "'<nowiki/>'''''Print barcode''''''" feature provided with Dolibarr 3.6+ (menu '''Tools''').

==Using barcode scanner==
If barcode number is not visible, or if you don't want to loose time typing all numbers, you can use a hardware barcode scanner. To be compatible with Dolibarr, your barcode scanner must support the "keyboard emulation": When you scan the barcode, it is like when typing the number from the keyboard.
To find a barcode scanner supporting such emulation, you must have a look a technical specification of barcode. Scanner must provide the term:

*"HID" mode (for Human Interface Device)

or

*"Keyboard Wedge" or "Wedge" interface

More information on page: http://www.taltech.com/barcodesoftware/articles/which_barcode_scanner_interface

You can find bar code reader to read barcode EAN13 (13 numbers) and others to read barcode code-39 (numeric, unlimited number of characters) or barcode code-128 (alphabet, unlimited number of characters). Most barcode scanner read all formats.

*EAN13 is used to define a product.
*code-39 is used for stock tracking (serial number with numeric character only).
*code-128 is used for stock tracking (serial number with numeric and alpha character).

To test your scanner can read code-128, you can use this page (print it before, most scanner don't work when used directly on computer screen display):
http://www.softmatic.com/faq-2-7.html

Example:

*MOTOROla DS4208
*Datalogic QW2120
*EAN: 6913280798816

This is another example tested successfuly on a Linux Ubuntu:

*http://www.amazon.fr/gp/product/B008RG3EG6
*Just plug the USB cable of scanner into your computer, then you need to scan the barcode on provided manuel to set the correct keyboard. Once done, every scan will be output as if you use the keyboard.

Modul Barcode

2022-09-25T07:55:28Z

Speaking services:

[[en:Module_Barcode]]
[[fr:Module_Codes_Barre]]
[[es:Módulo_Código_de_barra]]


[[Category:Barcode]]
{{TemplateDocUser}}
{{TemplateModDE Developer}}
{{BasculeDevUserDe|
name=Barcode|
num=55|
devdoc=[[Modul Barcode (developer)]]|
userdoc=This page}}

= Einleitung =
Diese Modul ermöglicht die Verwendung von Barcodes in Dolibarr (z.B. zum Druck in Belegen).

= Installation =
{{NoInstallModuleDE}}

= Konfiguration =
{{ActivationModuleDE}}

==Barcode-Kodierungstyp==
Auf der Einstellungs-Seite wählen Sie für jedes Barcodeformat, das Sie unterstützen möchten, die Engine, die die grafische Ausgabe (Bild) des Barcodes erstellt.

Die standardmäßig verfügbaren und von den Dolibarr-Entwicklern unterstützten Engines sind die Dolibarr-interne Engine auf Basis von '''php-barcode''' und TCPDF-barcode, die den in der TCPDF-Bibliothek verfügbaren Barcode-Generator nutzt.

Bei Bedarf können Sie das Programm genbarcode (http://www.ashberg.de/php-barcode/download/#genbarcode) installieren, um weitere von dieser Engine unterstützte Formate zu erhalten. Die Quellen für das Kommandozeilenprogramm '''genbarcode''' sind auch hier verfügbar: [[Datei:Genbarcode-0.4.tar.gz]]

Sie können auch neue Barcode-Generator-Engines installieren (siehe im Downloadbereich von http://www.dolibarr.org), um weitere Formate zu unterstützen.

==Weitere Optionen==
Wählen Sie dann auf der Seite für die Moduleinrichtung stets aus, welche Funktion Sie mit Barcodes erweitern möchten:

*Verwaltung der Produkte
*Verwaltung der Partner

==Manager zur automatischen Definition von Barcode-Nummern (Produkt)==
Aktivieren Sie das Nummerierungsmodul, das Sie zum Vorschlagen und Validieren von Barcode-Nummern für Produkte verwenden möchten. Definieren Sie auch eine Maske, damit die automatische Nummerierung funktioniert.

Wenn Sie z. B. bei der vorherigen Einrichtung das EAN-Format ( http://en.wikipedia.org/wiki/International_Article_Number_(EAN) ) für Produkte gewählt haben, können Sie den Wert auf folgende Weise eingeben:
<syntaxHighlight lang="ini">
300999{000000}
</syntaxHighlight>

*Where 300 is the country number (See http://www.gs1.org/barcodes/support/prefix_list)
*999 is the Company number (according to country it may have more digits). To get a number for your company, you must contact the GS1 for your country: http://www.gs1.org/contact
*{000000} is the product number. You decide this number. It is counter with maximum 6 digits (according to country it may have less digits). Length is (8 - number of digits for your company number).
*Checksum digit is not required for EAN13 (it is added automatically)

Note: A barcode EAN13 identify in most cases a product (as a template), like do the reference of a product (also called '''Part number'''). Identification of the serial or lot can be done with the '''Serial No''' also called '''SSN''', '''S/N''', or '''SN''' or the '''Product No'''. Serial and Product are sometimes an autonomous bar code number, sometimes included into a EAN128 code: http://www.barcodeisland.com/uccean128.phtml. A serial may be a lot or a unique instance of a product (that is a lot of 1).

Note: The '''SKU''' is a generic term to say: "The ID enough accurate to manage stock". So SKU depends if you use lot or not. It can be a '''Part number''' or a '''Serial No'''. Best thing is to avoid using this term to avoid confusion.

=Usage=
Once the setup step is finished, you will see a new field "bar code" on some screens, depending on what you choosed for features to enhance (third party screen and/or product screen).
You can then enter barcode values in such fields, using keyboard or barcode scanner:
==Using keyboard==
Just enter the number represented into the barcode. This suppose that number was printed under barcode graphic. This will be the case if you print the barcode stickker using the "'<nowiki/>'''''Print barcode''''''" feature provided with Dolibarr 3.6+ (menu '''Tools''').

==Using barcode scanner==
If barcode number is not visible, or if you don't want to loose time typing all numbers, you can use a hardware barcode scanner. To be compatible with Dolibarr, your barcode scanner must support the "keyboard emulation": When you scan the barcode, it is like when typing the number from the keyboard.
To find a barcode scanner supporting such emulation, you must have a look a technical specification of barcode. Scanner must provide the term:

*"HID" mode (for Human Interface Device)

or

*"Keyboard Wedge" or "Wedge" interface

More information on page: http://www.taltech.com/barcodesoftware/articles/which_barcode_scanner_interface

You can find bar code reader to read barcode EAN13 (13 numbers) and others to read barcode code-39 (numeric, unlimited number of characters) or barcode code-128 (alphabet, unlimited number of characters). Most barcode scanner read all formats.

*EAN13 is used to define a product.
*code-39 is used for stock tracking (serial number with numeric character only).
*code-128 is used for stock tracking (serial number with numeric and alpha character).

To test your scanner can read code-128, you can use this page (print it before, most scanner don't work when used directly on computer screen display):
http://www.softmatic.com/faq-2-7.html

Example:

*MOTOROla DS4208
*Datalogic QW2120
*EAN: 6913280798816

This is another example tested successfuly on a Linux Ubuntu:

*http://www.amazon.fr/gp/product/B008RG3EG6
*Just plug the USB cable of scanner into your computer, then you need to scan the barcode on provided manuel to set the correct keyboard. Once done, every scan will be output as if you use the keyboard.

Módulo Código de barra (desarrollador)

2022-09-25T07:38:47Z

Speaking services:

[[de:Modul_Barcode_(Developer)]]
[[fr:Module_Codes_Barre_(développeur)]]
[[es:Módulo_Código_de_barra_(desarrollador)]]


[[Category:BarcodeEs]]
[[Category:Listado_de_Módulos_(desarrollador)]]
{{TemplateDocDesarrollo}}
{{TemplateModES_Desarrollador}}
{{BasculeDevUsuario|
nom=Código de barra|
num=55|
devdoc=Esta página|
userdoc=[[Módulo Código de barra]]}}

= Función =
Gestión de códigos de barra. Permite la posibilidad de indicar un valor de código de barras a los productos o los terceros.

= Permisos =
*->barcode->lire
*->barcode->creer
*->barcode->supprimer

= Tablas SQL =
Ninguna

Module Codes Barre (développeur)

2022-09-25T07:38:02Z

Speaking services:

[[de:Modul_Barcode_(Developer)]]
[[fr:Module_Codes_Barre_(développeur)]]
[[es:Módulo_Código_de_barra_(desarrollador)]]


[[Category:Codes barre]]
[[Category:Liste des Modules (développeur)‎]]
{{TemplateDocDev}}
{{TemplateModFR_Développeur}}
{{BasculeDevUser|
nom=Barcode|
num=55|
devdoc=Cette page|
userdoc=[[Module Codes Barre]]}}

= Fonction =
Gestion des codes barre. Ce module permet d'ajouter la possibilité de saisir une valeur de code barre sur les produits ou les tiers.

= Permissions =
*->barcode->lire
*->barcode->creer
*->barcode->supprimer

= Tables SQL =
Aucune.

Modul Barcode (Developer)

2022-09-25T07:36:04Z

Speaking services:

[[de:Modul_Barcode_(Developer)]]
[[fr:Module_Codes_Barre_(développeur)]]
[[es:Módulo_Código_de_barra_(desarrollador)]]


[[Category:Barcode]]
[[Category:List of Modules (developer)‎]]
{{TemplateDocDevDe}}
{{TemplateModDE}}
{{BasculeDevUserDe|
name=Barcode|
num=55|
devdoc=This page|
userdoc=[[Module Barcode]]}}

= Funktion =
Verwaltung von Barcodes.
Dies fügt die Möglichkeit hinzu, einen Barcodewert für Produkte oder Partner zu erstellen und als grafische Barcodes darzustellen, wo es passt.

= Permissions =
*->barcode->lire
*->barcode->creer
*->barcode->supprimer

= Tables SQL =
Keine

Modul Barcode (Developer)

2022-09-25T07:34:54Z

Speaking services:

[[de:Modul_Barcode_(Developer)]]
[[fr:Module_Codes_Barre_(développeur)]]
[[es:Módulo_Código_de_barra_(desarrollador)]]


[[Category:Barcode]]
[[Category:List of Modules (developer)‎]]
{{TemplateDocDevEn}}
{{TemplateModEN}}
{{BasculeDevUserEn|
name=Barcode|
num=55|
devdoc=This page|
userdoc=[[Module Barcode]]}}

= Funktion =
Verwaltung von Barcodes.
Dies fügt die Möglichkeit hinzu, einen Barcodewert für Produkte oder Partner zu erstellen und als grafische Barcodes darzustellen, wo es passt.

= Permissions =
*->barcode->lire
*->barcode->creer
*->barcode->supprimer

= Tables SQL =
Keine

Modul Barcode (Developer)

2022-09-25T07:30:39Z

Speaking services:

[[en:Modul_Barcode_(Developer)]]
[[fr:Module_Codes_Barre_(développeur)]]
[[es:Módulo_Código_de_barra_(desarrollador)]]


[[Category:Barcode]]
[[Category:List of Modules (developer)‎]]
{{TemplateDocDevEn}}
{{TemplateModEN}}
{{BasculeDevUserEn|
name=Barcode|
num=55|
devdoc=This page|
userdoc=[[Module Barcode]]}}

= Funktion =
Verwaltung von Barcodes.
Dies fügt die Möglichkeit hinzu, einen Barcodewert für Produkte oder Partner zu erstellen und als grafische Barcodes darzustellen, wo es passt.

= Permissions =
*->barcode->lire
*->barcode->creer
*->barcode->supprimer

= Tables SQL =
Keine

Modul Barcode (Developer)

2022-09-25T07:28:52Z

Speaking services: Created page with " <!-- You can edit this section but do NOT remove these comments Links below will be automatically replicated on translated pages by..."

[[fr:Module_Codes_Barre_(développeur)]]
[[es:Módulo_Código_de_barra_(desarrollador)]]
[[de:Modul_Barcode_(Developer)]]


[[Category:Barcode]]
[[Category:List of Modules (developer)‎]]
{{TemplateDocDevEn}}
{{TemplateModEN}}
{{BasculeDevUserEn|
name=Barcode|
num=55|
devdoc=This page|
userdoc=[[Module Barcode]]}}

= Funktion =
Verwaltung von Barcodes.
Dies fügt die Möglichkeit hinzu, einen Barcodewert für Produkte oder Dritte einzugeben und grafische Barcodes zu sehen, wo es passt.

= Permissions =
*->barcode->lire
*->barcode->creer
*->barcode->supprimer

= Tables SQL =
None

Module Barcode (developer)

2022-09-25T07:25:55Z

Speaking services:

[[fr:Module_Codes_Barre_(développeur)]]
[[es:Módulo_Código_de_barra_(desarrollador)]]
[[de:Modul_Barcode_(Developer)]]


[[Category:Barcode]]
[[Category:List of Modules (developer)‎]]
{{TemplateDocDevEn}}
{{TemplateModEN}}
{{BasculeDevUserEn|
name=Barcode|
num=55|
devdoc=This page|
userdoc=[[Module Barcode]]}}

= Function =
Management of barcode.
This add ability to enter a barcode value for products or third parties and to see graphical barcodes where it suits.

= Permissions =
*->barcode->lire
*->barcode->creer
*->barcode->supprimer

= Tables SQL =
None

Module Barcode

2022-09-25T07:22:34Z

Speaking services:

[[fr:Module_Codes_Barre]]
[[es:Módulo_Código_de_barra]]
[[de:Modul_Barcode]]


[[Category:Barcode]]
{{TemplateDocUser}}
{{TemplateModEN Developer}}
{{BasculeDevUserEn|
name=Barcode|
num=55|
devdoc=[[Module Barcode (developer)]]|
userdoc=This page}}

=Introduction=
The bar code module allows you to add bar codes where it can be usefull (like on products cards or third parties).

=Installation=
{{NoInstallModuleEn}}

=Configuration=
{{ActivationModuleEn}}

==Barcode encoding type==
On the setup page, you choose for each barcode format you want to support, the engine that will build the graphical output (image) of bar code.

The engines available by default and supported by Dolibarr developers are the Dolibarr internal engine based on '''php-barcode''' and TCPDF-barcode which makes use of the barcode generator available in the TCPDF library.

Eventually, you can install the program genbarcode (http://www.ashberg.de/php-barcode/download/#genbarcode) to have more format supported by this engine. Sources for the command line '''genbarcode''' program is also available here: [[File:Genbarcode-0.4.tar.gz]]

You can also install new barcode generator engines (see in download area of http://www.dolibarr.org) to support more format.

==Other options==
Then, always on module setup page, choose which feature you want to enhance with barcodes:

*Products management
*Third parties management

==Manager to auto define barcode numbers (Product)==
Enable numbering module you want to use for suggesting and validating barcode number for products. Define also mask to make the automatic numbering generation working.

For example, if you choosed to use the EAN format ( http://en.wikipedia.org/wiki/International_Article_Number_(EAN) ) for products in previous setup, you can enter the value:
<syntaxHighlight lang="ini">
300999{000000}
</syntaxHighlight>

*Where 300 is the country number (See http://www.gs1.org/barcodes/support/prefix_list)
*999 is the Company number (according to country it may have more digits). To get a number for your company, you must contact the GS1 for your country: http://www.gs1.org/contact
*{000000} is the product number. You decide this number. It is counter with maximum 6 digits (according to country it may have less digits). Length is (8 - number of digits for your company number).
*Checksum digit is not required for EAN13 (it is added automatically)

Note: A barcode EAN13 identify in most cases a product (as a template), like do the reference of a product (also called '''Part number'''). Identification of the serial or lot can be done with the '''Serial No''' also called '''SSN''', '''S/N''', or '''SN''' or the '''Product No'''. Serial and Product are sometimes an autonomous bar code number, sometimes included into a EAN128 code: http://www.barcodeisland.com/uccean128.phtml. A serial may be a lot or a unique instance of a product (that is a lot of 1).

Note: The '''SKU''' is a generic term to say: "The ID enough accurate to manage stock". So SKU depends if you use lot or not. It can be a '''Part number''' or a '''Serial No'''. Best thing is to avoid using this term to avoid confusion.

=Usage=
Once the setup step is finished, you will see a new field "bar code" on some screens, depending on what you choosed for features to enhance (third party screen and/or product screen).
You can then enter barcode values in such fields, using keyboard or barcode scanner:
==Using keyboard==
Just enter the number represented into the barcode. This suppose that number was printed under barcode graphic. This will be the case if you print the barcode stickker using the "'<nowiki/>'''''Print barcode''''''" feature provided with Dolibarr 3.6+ (menu '''Tools''').

==Using barcode scanner==
If barcode number is not visible, or if you don't want to loose time typing all numbers, you can use a hardware barcode scanner. To be compatible with Dolibarr, your barcode scanner must support the "keyboard emulation": When you scan the barcode, it is like when typing the number from the keyboard.
To find a barcode scanner supporting such emulation, you must have a look a technical specification of barcode. Scanner must provide the term:

*"HID" mode (for Human Interface Device)

or

*"Keyboard Wedge" or "Wedge" interface

More information on page: http://www.taltech.com/barcodesoftware/articles/which_barcode_scanner_interface

You can find bar code reader to read barcode EAN13 (13 numbers) and others to read barcode code-39 (numeric, unlimited number of characters) or barcode code-128 (alphabet, unlimited number of characters). Most barcode scanner read all formats.

*EAN13 is used to define a product.
*code-39 is used for stock tracking (serial number with numeric character only).
*code-128 is used for stock tracking (serial number with numeric and alpha character).

To test your scanner can read code-128, you can use this page (print it before, most scanner don't work when used directly on computer screen display):
http://www.softmatic.com/faq-2-7.html

Example:

*MOTOROla DS4208
*Datalogic QW2120
*EAN: 6913280798816

This is another example tested successfuly on a Linux Ubuntu:

*http://www.amazon.fr/gp/product/B008RG3EG6
*Just plug the USB cable of scanner into your computer, then you need to scan the barcode on provided manuel to set the correct keyboard. Once done, every scan will be output as if you use the keyboard.

FAQ Get, update GIT Projekt Quellen

2022-09-24T10:20:07Z

Speaking services: /* Einen Konflikt lösen */

[[en:FAQ_Get,update_GIT_project_sources]]
[[fr:FAQ_Récupérer,_mettre_à_jour_les_sources_GIT_du_projet]]
[[es:FAQ_Recuperar,_actualizar_GIT_fuentes_del_proyecto]]


[[Category:FAQ DE]]
Hier finden Sie Informationen darüber, wie Sie die Quellen des Dolibarr-Projekts erhalten können.
Es werden mehrere Methoden beschrieben, aber wir empfehlen, die auf GitHub basierende Methode zu verwenden.

 

=Letzte Version der Quellen durch tgz-Download abrufen=
Diese Methode kann auch von nicht-technischen Benutzern verwendet werden.
Sie ermöglicht es Ihnen, die Quellen des Hauptentwicklungszweigs (HEAD genannt) zu erhalten, indem Sie einfach eine Datei herunterladen: Diese Operation besteht darin, die letzte Version der Dolibarr-Dateien zu erhalten, die jede Nacht in eine tgz-Datei gepackt werden. Die Datei ist über einen Link verfügbar:

{{LinkLastSnapshot}}

Neue Dateien überschreiben alte Dateien. Der Nachteil dieser Methode ist, dass Sie das Paket jedes Mal herunterladen und dekomprimieren müssen, wenn Sie Updates erhalten möchten.

Entwickler sollten diese Methode nicht verwenden, um Quellen zu erhalten, sondern die nächste.

=Letzte Version der Quellen über einen anonymen GIT-Zugang abrufen=
Sie können diese Methode verwenden, wenn Sie keinen GIT-Zugang haben. Mit dieser Methode können Sie keine Änderungen einreichen. Wenn Sie also ein Entwickler sind, sollten Sie ein GitHub-Konto erstellen und die nächste Methode anstelle dieser Methode verwenden.

==Voraussetzungen==

*Mit Eclipse IDE

Zuerst müssen Sie eine funktionierende Installation von Eclipse haben. Das '''EGit'''-Plugin muss ebenfalls installiert worden sein.
Verwenden Sie dazu den '''Find And Install process''' im Eclipse Menü, fügen Sie die GIT update URL hinzu:
https://download.eclipse.org/egit/updates
Wählen Sie dann '''EGit''' zur Installation aus (JGit muss nicht ausgewählt werden)

*Mit der GIT-Kommandozeilen-Client-Schnittstelle

Sie müssen den GIT-Client installieren (das GIT-Befehlszeilentool wird unter Linux mit "sudo apt-get install git" installiert, für Windows ist der GIT-Client unter https://git-scm.com/download/win zu finden).

==Clone Prozess==
Geben Sie zunächst den Wert des Repositorys mit den Referenzquellen in Ihr GIT-Client-Tool ein.

*Mit Eclipse, gehen Sie in die Perspektive GIT, klicken Sie auf den Button "GIT Repository klonen". Geben Sie die GIT-URL des Projekts ein, das Sie erhalten möchten.
<source lang="ini">
git://github.com/Dolibarr/dolibarr.git (read only)
oder wenn Sie einen Fork von dolibarr github von der github-Weboberfläche erstellt haben
git@github.com:yourgitaccount/dolibarr.git (read and write access)
</source>
Ihr Eclipse-GIT-Client wird Sie auffordern, die Branches auszuwählen, an denen Sie interessiert sind. Branches, die jetzt noch nicht ausgewählt sind, können später durch einen "Fetch" aus der "Remotes"-Ansicht ausgewählt werden, aber versuchen Sie, nur den Branch auszuwählen, den Sie benötigen. Dies erspart Ihnen später Zeit und Probleme.

Hinweis: Wenn Sie sich hinter einer Firewall befinden, müssen Sie die Eclipse-Proxy-Zugangsdaten im Eclipse-Menü Fenster - Einstellungen - Allgemein - Netzwerkverbindung einstellen und die alternative URL verwenden:
<source lang="ini">
https://gitlogin:gitpassword@github.com/yourgitaccount/dolibarr.git
</source>

*Mit GIT auf der Befehlszeilenschnittstelle:

Richten Sie zunächst Ihren Git-Client ein:
<source lang="bash">
git config --global user.name "Your Name"
git config --global user.email "user@domain.com"
git config --list
</source>
Dann klonen Sie das Repository lokal:
<source lang="bash">
git://github.com/Dolibarr/dolibarr.git (nur lesen)
oder wenn Sie einen Fork von dolibarr github von der github-Weboberfläche erstellt haben
git@github.com:yourgitaccount/dolibarr.git (Lese- und Schreibzugriff)
</source>

Hinweis: Wenn Sie sich hinter einer Firewall befinden, müssen Sie Ihre Proxy-Informationen einstellen und die alternative https-URL verwenden:
<source lang="bash">
git config --global http.proxy http://proxyuser:proxypass@proxyserver:proxyport
git clone https://gitlogin:gitpassword@github.com/yourgitaccount/dolibarr.git dolibarr
</source>

Sobald dieser Schritt bestätigt ist, lädt Ihr GIT-Client alle Dateien vom entfernten GIT-Server herunter. Dies kann einige Sekunden oder Minuten dauern.

Sobald der Download abgeschlossen ist, müssen Sie wählen, an welchem Zweig Sie arbeiten möchten.

*Mit GIT auf der Befehlszeilenschnittstelle;

<source lang="bash">
git checkout develop
git checkout x.y
</source>
Dadurch wird eine lokale Branche erstellt und automatisch ein Checkout durchgeführt.

*Klicken Sie in Eclipse mit der rechten Maustaste auf "Branches - Remotes -" die Branche, die Sie lokal duplizieren möchten".
Wählen Sie " Erstelle Branch" (und markieren Sie das Kästchen "Checkout"). Dadurch wird der Inhalt der Branche dupliziert, um lokal daran zu arbeiten, und Ihr "Arbeitsverzeichnis" wird aktualisiert, um an dieser Branche zu arbeiten.

Erstellen Sie ein Eclipse-Projekt:

Wenn Sie Eclipse verwenden, erstellen Sie, sobald die Verzweigung lokal erstellt wurde, ein PHP-Projekt aus dem Assistenten, indem Sie "'''Create from existing project'''" wählen und das Verzeichnis auswählen, das Ihr lokales GIT-Repository ist (Wählen Sie nicht die Option, ein PHP-Projekt komplett neu zu erstellen).

Klicken Sie dann mit der rechten Maustaste auf das Projekt in Ihrem Eclipse-Arbeitsbereich und wählen Sie "'''Team - Share'''". Wählen Sie GIT und klicken Sie auf die Option "'''Use or create repository in parent folder of project'''".
Eine alternative Methode ist File->Import, Git->Project von Git, Wählen Sie das Git-Repository und Weiter, Assistent für neue Projekte verwenden -> Php-Projekt, geben Sie den Ordner Ihres lokalen GIT-Repositorys ein.

Dann können Sie Eclipse so einstellen, dass es nicht alle Projektdateien für seine Build-Tools (Outline Scanner, TODO Scanner, Syntax Scanner...) scannt. Dies verhindert, dass Eclipse zu langsam ist. Klicken Sie dazu mit der rechten Maustaste auf das Projekt, wählen Sie Build Path und stellen Sie es wie im folgenden Screenshot ein.

[[File:Eclipse php build path.png|240px]]

=Abrufen der letzten Version der Quellen über einen GitHub-Nutzerzugang=
==Voraussetzung==

*Mit Eclipse IDE

Sie müssen zuvor ein Konto auf GitHub (https://github.com/) erstellen und ein öffentliches RSA- oder DSA-Zertifikat in Ihr Kontoprofil hochladen.

Dann müssen Sie eine funktionierende Installation von Eclipse haben. Das '''EGit'''-Plugin muss ebenfalls installiert worden sein.
https://download.eclipse.org/egit/updates
Wählen Sie dann die Installation von '''EGit'''.
*Mit der GIT-Kommandozeilen-Schnittstelle:

Sie müssen zuvor ein Konto auf GitHub (https://github.com/) erstellen und ein öffentliches RSA- oder DSA-Zertifikat in Ihr Kontoprofil hochladen.

Dann müssen Sie den GIT-Client installieren (GIT-Kommandozeilen-Tool unter Linux mit "sudo apt-get install git" oder den GIT-Client für Windows unter https://git-scm.com/download/win).

==Fork Prozess==
Melden Sie sich bei Github mit den Login-Daten an, das Sie im vorherigen Schritt erstellt haben. Gehen Sie dann auf die Seite

https://github.com/Dolibarr/dolibarr

und klicken Sie auf die Schaltfläche "Fork".

Dadurch wird eine Kopie (ein Fork) des Projekts in Ihrem eigenen Github-Bereich erstellt. Da Sie der Besitzer dieses Forks sind, haben Sie alle Rechte, die Sie für die nächsten Schritte benötigen.

==Clone Prozess==
Dann ist der Prozess derselbe wie bei der Beschaffung von Quellen mit anonymen Zugriff.

Die für den GIT-Clone zu verwendende URL ist dieselbe:
<source lang="ini">
git@github.com:YourGitHubLogin/dolibarr.git
</source>

Beachten Sie, dass es auch eine HTTPS-URL gibt, die aber manchmal offline ist (verwenden Sie also lieber die erste, ein Link mit HTTPS ist nur erforderlich, wenn Sie sich hinter einer Firewall befinden):

<source lang="ini">
https://yourgithublogin@github.com/Dolibarr/dolibarr.git
</source>

=Update des Repository=
So aktualisieren Sie Ihren lokalen Workspace:

*Mit Eclipse IDE:

Rechtsklick auf das Eclipse-Projekt und Auswahl von "Pull".

Wenn Sie in Ihrem Eclipse-Workspace Änderungen an Dateien vorgenommen haben, die in der GIT-Remote-Referenz geändert wurden, wird Ihr GIT-Client automatisch einen Merge durchführen.

*Wenn es Konflikte gibt, wird der Merge alle Konfliktdateien als "Konflikt" markieren (siehe später, um diesen Zustand zu lösen).
*Wenn nicht, erhalten Sie alle Dateien in der neuen Version, einschließlich aller Ihrer Änderungen.

Wenn Sie bereits einige Dateien in Ihr lokales Repository übertragen haben, wird Ihr Workspace als "Zusammengeführt" markiert.
Alles was Sie tun müssen, ist ein Commit zu machen, um Ihr lokales Repository zu bestätigen, dass es sowohl Ihre Änderungen als auch die Änderungen anderer enthält.

*Mit dem GIT Command Line Client Interface:

<source lang="bash">
git pull
</source>

=Commit und Veröffentlichen von Änderungen=
Um alle Änderungen zu sehen, die Sie in Ihrem Arbeitsverzeichnis vorgenommen haben und die darauf warten, in Git hinzugefügt zu werden:

*Mit GIT Command Line Interface:

<source lang="bash">
git status
git diff subdir/filename
</source>

Um Änderungen, die Sie in Ihrem lokalen Repository vorgenommen haben, in den GIT-Index aufzunehmen, führen Sie einen commit-Befehl für diesen Index durch:

*Mit Eclipse: Klicken Sie mit der rechten Maustaste auf die zu übertragende Datei oder das Verzeichnis. Wählen Sie die Datei zum Hinzufügen/Entfernen/Aktualisieren in den nächsten Commit.
*Mit GIT Command Line Interface:

<source lang="bash">
git commit -a -m "Commit text"
</source>
Dadurch werden Hinzufügungen und Änderungen in Ihrem lokalen Branch gespeichert.

Um sie auf den GIT-Repository-Server zu pushen,

*With Eclipse: Klicken Sie mit der rechten Maustaste auf das Projekt und wählen Sie "'''Team - Push to Upstream'''".
*With GIT Command Line Interface:

<source lang="bash">
git push
</source>

Um ein Commit abzubrechen:

*Mit GIT Command Line Interface, wenn der Commit noch nicht gepusht wurde:

<source lang="bash">
git reset --soft HEAD~1
</source>

*Mit GIT Command Line Interface, wenn ein Commit bereits gepusht wurde:

<source lang="bash">
git revert IdCommit or git revert HEAD (for last commit)
</source>

Um Änderungen, die in Ihrer GIT-Instanz vorgenommen wurden, in die offizielle Dolibarr-Instanz einzubinden:

*Gehen Sie in die GitHub-Weboberfläche Ihrer geforkten Git-Instanz.
*Klicken Sie auf die kleine Schaltfläche "Create a Pull request".
*Wählen Sie den Commit aus, dessen Aufnahme Sie beantragen, und validieren Sie ihn.

=Anfrage stellen, um die Änderungen in das offizielle Projekt zu übernehmen=
Sobald Sie einen oder mehrere Commits in Ihren remote Fork-Bereich auf Github gepusht haben, können Sie das Dolibarr-Kernteam bitten, diese in das offizielle Projekt aufzunehmen.
Folgen Sie dazu dieser Anleitung: https://help.github.com/articles/creating-a-pull-request/

=Hinzufügen eines externen Commits zum aktuellen Repository=
Einige Entwickler fügen ihre Änderungen durch Commits in ihr eigenes Git-Repository hinzu, nachdem sie das Projekt geforkt haben. Wenn Sie daran interessiert sind, diese Änderungen zu erhalten, können Sie sie mit den folgenden Schritten importieren.

Hierfür benötigen Sie sowohl Eclipse als auch das GIT Command Line Interface:

*Gehen Sie zunächst in die GIT-Setup-Ansicht und klicken Sie mit der rechten Maustaste auf "'''Remotes'''" in Ihrem Eclipse-Git-Workspace und wählen Sie "'''Create a remote...'''"
*Geben Sie den Namen des entfernten Forks ein, den der Entwickler erstellt hat (in den meisten Fällen ist es das Git-Login des Entwicklers). Zum Beispiel: "'''thedevlogin'''". Wählen Sie auch "'''Configure Fetch'''".
*Geben Sie die URI des Git-Repositorys des Entwicklers ein. Zum Beispiel: '''git://github.com/thedevlogin/dolibarr.git'''. Fügen Sie auch einen refspec-Wert hinzu, um den Branch anzugeben, den Sie abrufen möchten. Zum Beispiel: '''refs/heads/master:refs/remotes/thedevlogin/master'''. Klicken Sie auf "'''Save and Fetch'''". Es wird ein neuer Eintrag in "Remote Tracking" hinzugefügt, der es ermöglicht, Commits in diesem Zweig zu lesen/zu schreiben.
Gehen Sie nun in die Kommandozeile Ihres Git-Repositorys (unter Linux ist es in den meisten Fällen '''/home/yourlogin/git/yourdolibarr''') und geben Sie den Befehl git cherry-pick ein:
<source lang="bash">
git cherry-pick -x commitid
</source>
wobei commitid der Wert der Commit-ID ist, die Sie erhalten möchten.

Sobald dies erledigt ist, gehen Sie zurück zu Eclipse und aktualisieren Sie das Projekt. Sie werden sehen, dass geänderte Dateien mit Dekoratoren erscheinen (mit Konflikten, wenn es welche gibt).

Wenn die Auswahl aufgrund von Konflikten fehlschlägt, können Sie den Versuch der Auswahl mit
<source lang="bash">
git cherry-pick --abort
</source>

=Einen Konflikt lösen=
Wenn eine Datei nach einem "Pull" als "Konflikt" markiert ist, öffnen Sie die Datei und bearbeiten Sie sie.
Suchen Sie nach dem String "<<<<<<<<<<", dann sehen Sie den Teil des Codes, der zwischen "<<<<<<<<<" und ">>>>>>>>" als Konflikt markiert ist. Bearbeiten Sie die Codezeilen manuell, um das Endergebnis zu erhalten, indem Sie auch die "<<<<<<<<" und ">>>>>>>" entfernen.

Klicken Sie dann mit der rechten Maustaste auf die Datei und wählen Sie " Hinzufügen".

Wenn Sie lieber alle Änderungen, die Sie an allen Dateien vorgenommen haben, vollständig rückgängig machen möchten (um Ihren Arbeitsbereich mit dem Inhalt des entfernten Repositoriums wiederherzustellen), können Sie einen Reset durchführen:

*Mit Eclipse klicken Sie mit der rechten Maustaste auf die oberste Zeile des Projekts und wählen Sie "Zurücksetzen" und dann "'''Hard'''" und dann "'''Reference - HEAD'''".
*Bei Verwendung des GIT-Befehlszeilentools erreichen Sie dies mit dem Befehl

<source lang="bash">
git reset --hard HEAD
</source>

=Taggen Sie die Quellen=
Mit den GIT-Kommandozeilenwerkzeugen:
Um ein Tag über eine Version zu erstellen:
<source lang="bash">
git tag -a -m "Release|Maintenance release x.y.z" "x.y.z"
oder
git tag -a -f -m "Beta x.y.betai" "x.y.betai_YYYYMMDD" idcommit # -f force wenn ein Tag bereits existiert, ermöglicht idcommit die Auswahl des zu taggenden Commits.
git push --tags # Pour pousser le tags sur le serveur distant
</source>

Um einen Tag zu löschen:
<source lang="bash">
git tag -d "x.y.z_YYYYMMDD"
git push origin :x.y.z_YYYYMMDD # Um die Löschung auf dem entfernten Server zu bestätigen
</source>

=Einen neue Branche erstellen=
Hier ist der Befehl, den Sie verwenden müssen, um einen neuen Zweig aus einem eigenen develop-Repository zu erstellen:
<source lang="bash">
git branch x.y
git push origin x.y
</source>

=Statistiken=
Mit den GIT-Kommandozeilenwerkzeugen:

Um die Anzahl der Änderungen zu zählen, die ein Entwickler zwischen Version x und y vorgenommen hat:

*Zuerst führen Sie "git merge-base" aus, um die ID des letzten gemeinsamen Commits zwischen x und y zu erfahren.

<source lang="bash">
git merge-base origin/3.1 origin/develop
</source>

*Dann führen Sie git log aus, um eine Liste aller Änderungen von der letzten gemeinsamen Übertragung bis zur letzten Übertragung zu erhalten.
<source lang="bash">
git log id_found_at_previous_step..HEAD
</source>

*Um die Gesamtzahl der hinzugefügten/gelöschten Zeilen zu ermitteln:
<source lang="bash">
git log --ancestry-path --numstat --pretty="%H" id_found_at_previous_step..HEAD | awk 'NF==3 {plus+=$1; minus+=$2} END {printf("+%d, -%d\n", plus, minus)}'
</source>

Zählen der endgültigen Änderungen zwischen einer Version x und y (dies unterscheidet sich von der vorherigen Zählung, da bei der vorherigen Zählung eine Änderung zweimal zu zwei verschiedenen Zeitpunkten durchgeführt werden kann, um unterschiedliche Änderungen vorzunehmen. Bei der zweiten Methode werden die Änderungen gezählt, die schließlich gefunden wurden, wenn die Änderungen beim ersten Versuch in Ordnung waren):

*Verwenden Sie die gleiche Methode wie zuvor, aber anstatt git log auszuführen, führen Sie '''git diff''' aus.

<source lang="bash">
git diff -b -M --numstat --pretty="%H" id_found_at_previous_step..HEAD | awk 'NF==3 {plus+=$1; minus+=$2} END {printf("+%d, -%d\n", plus, minus)}'
</source>

Weitere Informationen über die Verwendung von GIT erhältlich unter: [http://wiki.eclipse.org/EGit/User_Guide ici].

[[Category:Development]]

FAQ Get, update GIT Projekt Quellen

2022-09-24T10:17:02Z

Speaking services: /* Hinzufügen eines externen Commits zum aktuellen Repository */

[[en:FAQ_Get,update_GIT_project_sources]]
[[fr:FAQ_Récupérer,_mettre_à_jour_les_sources_GIT_du_projet]]
[[es:FAQ_Recuperar,_actualizar_GIT_fuentes_del_proyecto]]


[[Category:FAQ DE]]
Hier finden Sie Informationen darüber, wie Sie die Quellen des Dolibarr-Projekts erhalten können.
Es werden mehrere Methoden beschrieben, aber wir empfehlen, die auf GitHub basierende Methode zu verwenden.

 

=Letzte Version der Quellen durch tgz-Download abrufen=
Diese Methode kann auch von nicht-technischen Benutzern verwendet werden.
Sie ermöglicht es Ihnen, die Quellen des Hauptentwicklungszweigs (HEAD genannt) zu erhalten, indem Sie einfach eine Datei herunterladen: Diese Operation besteht darin, die letzte Version der Dolibarr-Dateien zu erhalten, die jede Nacht in eine tgz-Datei gepackt werden. Die Datei ist über einen Link verfügbar:

{{LinkLastSnapshot}}

Neue Dateien überschreiben alte Dateien. Der Nachteil dieser Methode ist, dass Sie das Paket jedes Mal herunterladen und dekomprimieren müssen, wenn Sie Updates erhalten möchten.

Entwickler sollten diese Methode nicht verwenden, um Quellen zu erhalten, sondern die nächste.

=Letzte Version der Quellen über einen anonymen GIT-Zugang abrufen=
Sie können diese Methode verwenden, wenn Sie keinen GIT-Zugang haben. Mit dieser Methode können Sie keine Änderungen einreichen. Wenn Sie also ein Entwickler sind, sollten Sie ein GitHub-Konto erstellen und die nächste Methode anstelle dieser Methode verwenden.

==Voraussetzungen==

*Mit Eclipse IDE

Zuerst müssen Sie eine funktionierende Installation von Eclipse haben. Das '''EGit'''-Plugin muss ebenfalls installiert worden sein.
Verwenden Sie dazu den '''Find And Install process''' im Eclipse Menü, fügen Sie die GIT update URL hinzu:
https://download.eclipse.org/egit/updates
Wählen Sie dann '''EGit''' zur Installation aus (JGit muss nicht ausgewählt werden)

*Mit der GIT-Kommandozeilen-Client-Schnittstelle

Sie müssen den GIT-Client installieren (das GIT-Befehlszeilentool wird unter Linux mit "sudo apt-get install git" installiert, für Windows ist der GIT-Client unter https://git-scm.com/download/win zu finden).

==Clone Prozess==
Geben Sie zunächst den Wert des Repositorys mit den Referenzquellen in Ihr GIT-Client-Tool ein.

*Mit Eclipse, gehen Sie in die Perspektive GIT, klicken Sie auf den Button "GIT Repository klonen". Geben Sie die GIT-URL des Projekts ein, das Sie erhalten möchten.
<source lang="ini">
git://github.com/Dolibarr/dolibarr.git (read only)
oder wenn Sie einen Fork von dolibarr github von der github-Weboberfläche erstellt haben
git@github.com:yourgitaccount/dolibarr.git (read and write access)
</source>
Ihr Eclipse-GIT-Client wird Sie auffordern, die Branches auszuwählen, an denen Sie interessiert sind. Branches, die jetzt noch nicht ausgewählt sind, können später durch einen "Fetch" aus der "Remotes"-Ansicht ausgewählt werden, aber versuchen Sie, nur den Branch auszuwählen, den Sie benötigen. Dies erspart Ihnen später Zeit und Probleme.

Hinweis: Wenn Sie sich hinter einer Firewall befinden, müssen Sie die Eclipse-Proxy-Zugangsdaten im Eclipse-Menü Fenster - Einstellungen - Allgemein - Netzwerkverbindung einstellen und die alternative URL verwenden:
<source lang="ini">
https://gitlogin:gitpassword@github.com/yourgitaccount/dolibarr.git
</source>

*Mit GIT auf der Befehlszeilenschnittstelle:

Richten Sie zunächst Ihren Git-Client ein:
<source lang="bash">
git config --global user.name "Your Name"
git config --global user.email "user@domain.com"
git config --list
</source>
Dann klonen Sie das Repository lokal:
<source lang="bash">
git://github.com/Dolibarr/dolibarr.git (nur lesen)
oder wenn Sie einen Fork von dolibarr github von der github-Weboberfläche erstellt haben
git@github.com:yourgitaccount/dolibarr.git (Lese- und Schreibzugriff)
</source>

Hinweis: Wenn Sie sich hinter einer Firewall befinden, müssen Sie Ihre Proxy-Informationen einstellen und die alternative https-URL verwenden:
<source lang="bash">
git config --global http.proxy http://proxyuser:proxypass@proxyserver:proxyport
git clone https://gitlogin:gitpassword@github.com/yourgitaccount/dolibarr.git dolibarr
</source>

Sobald dieser Schritt bestätigt ist, lädt Ihr GIT-Client alle Dateien vom entfernten GIT-Server herunter. Dies kann einige Sekunden oder Minuten dauern.

Sobald der Download abgeschlossen ist, müssen Sie wählen, an welchem Zweig Sie arbeiten möchten.

*Mit GIT auf der Befehlszeilenschnittstelle;

<source lang="bash">
git checkout develop
git checkout x.y
</source>
Dadurch wird eine lokale Branche erstellt und automatisch ein Checkout durchgeführt.

*Klicken Sie in Eclipse mit der rechten Maustaste auf "Branches - Remotes -" die Branche, die Sie lokal duplizieren möchten".
Wählen Sie " Erstelle Branch" (und markieren Sie das Kästchen "Checkout"). Dadurch wird der Inhalt der Branche dupliziert, um lokal daran zu arbeiten, und Ihr "Arbeitsverzeichnis" wird aktualisiert, um an dieser Branche zu arbeiten.

Erstellen Sie ein Eclipse-Projekt:

Wenn Sie Eclipse verwenden, erstellen Sie, sobald die Verzweigung lokal erstellt wurde, ein PHP-Projekt aus dem Assistenten, indem Sie "'''Create from existing project'''" wählen und das Verzeichnis auswählen, das Ihr lokales GIT-Repository ist (Wählen Sie nicht die Option, ein PHP-Projekt komplett neu zu erstellen).

Klicken Sie dann mit der rechten Maustaste auf das Projekt in Ihrem Eclipse-Arbeitsbereich und wählen Sie "'''Team - Share'''". Wählen Sie GIT und klicken Sie auf die Option "'''Use or create repository in parent folder of project'''".
Eine alternative Methode ist File->Import, Git->Project von Git, Wählen Sie das Git-Repository und Weiter, Assistent für neue Projekte verwenden -> Php-Projekt, geben Sie den Ordner Ihres lokalen GIT-Repositorys ein.

Dann können Sie Eclipse so einstellen, dass es nicht alle Projektdateien für seine Build-Tools (Outline Scanner, TODO Scanner, Syntax Scanner...) scannt. Dies verhindert, dass Eclipse zu langsam ist. Klicken Sie dazu mit der rechten Maustaste auf das Projekt, wählen Sie Build Path und stellen Sie es wie im folgenden Screenshot ein.

[[File:Eclipse php build path.png|240px]]

=Abrufen der letzten Version der Quellen über einen GitHub-Nutzerzugang=
==Voraussetzung==

*Mit Eclipse IDE

Sie müssen zuvor ein Konto auf GitHub (https://github.com/) erstellen und ein öffentliches RSA- oder DSA-Zertifikat in Ihr Kontoprofil hochladen.

Dann müssen Sie eine funktionierende Installation von Eclipse haben. Das '''EGit'''-Plugin muss ebenfalls installiert worden sein.
https://download.eclipse.org/egit/updates
Wählen Sie dann die Installation von '''EGit'''.
*Mit der GIT-Kommandozeilen-Schnittstelle:

Sie müssen zuvor ein Konto auf GitHub (https://github.com/) erstellen und ein öffentliches RSA- oder DSA-Zertifikat in Ihr Kontoprofil hochladen.

Dann müssen Sie den GIT-Client installieren (GIT-Kommandozeilen-Tool unter Linux mit "sudo apt-get install git" oder den GIT-Client für Windows unter https://git-scm.com/download/win).

==Fork Prozess==
Melden Sie sich bei Github mit den Login-Daten an, das Sie im vorherigen Schritt erstellt haben. Gehen Sie dann auf die Seite

https://github.com/Dolibarr/dolibarr

und klicken Sie auf die Schaltfläche "Fork".

Dadurch wird eine Kopie (ein Fork) des Projekts in Ihrem eigenen Github-Bereich erstellt. Da Sie der Besitzer dieses Forks sind, haben Sie alle Rechte, die Sie für die nächsten Schritte benötigen.

==Clone Prozess==
Dann ist der Prozess derselbe wie bei der Beschaffung von Quellen mit anonymen Zugriff.

Die für den GIT-Clone zu verwendende URL ist dieselbe:
<source lang="ini">
git@github.com:YourGitHubLogin/dolibarr.git
</source>

Beachten Sie, dass es auch eine HTTPS-URL gibt, die aber manchmal offline ist (verwenden Sie also lieber die erste, ein Link mit HTTPS ist nur erforderlich, wenn Sie sich hinter einer Firewall befinden):

<source lang="ini">
https://yourgithublogin@github.com/Dolibarr/dolibarr.git
</source>

=Update des Repository=
So aktualisieren Sie Ihren lokalen Workspace:

*Mit Eclipse IDE:

Rechtsklick auf das Eclipse-Projekt und Auswahl von "Pull".

Wenn Sie in Ihrem Eclipse-Workspace Änderungen an Dateien vorgenommen haben, die in der GIT-Remote-Referenz geändert wurden, wird Ihr GIT-Client automatisch einen Merge durchführen.

*Wenn es Konflikte gibt, wird der Merge alle Konfliktdateien als "Konflikt" markieren (siehe später, um diesen Zustand zu lösen).
*Wenn nicht, erhalten Sie alle Dateien in der neuen Version, einschließlich aller Ihrer Änderungen.

Wenn Sie bereits einige Dateien in Ihr lokales Repository übertragen haben, wird Ihr Workspace als "Zusammengeführt" markiert.
Alles was Sie tun müssen, ist ein Commit zu machen, um Ihr lokales Repository zu bestätigen, dass es sowohl Ihre Änderungen als auch die Änderungen anderer enthält.

*Mit dem GIT Command Line Client Interface:

<source lang="bash">
git pull
</source>

=Commit und Veröffentlichen von Änderungen=
Um alle Änderungen zu sehen, die Sie in Ihrem Arbeitsverzeichnis vorgenommen haben und die darauf warten, in Git hinzugefügt zu werden:

*Mit GIT Command Line Interface:

<source lang="bash">
git status
git diff subdir/filename
</source>

Um Änderungen, die Sie in Ihrem lokalen Repository vorgenommen haben, in den GIT-Index aufzunehmen, führen Sie einen commit-Befehl für diesen Index durch:

*Mit Eclipse: Klicken Sie mit der rechten Maustaste auf die zu übertragende Datei oder das Verzeichnis. Wählen Sie die Datei zum Hinzufügen/Entfernen/Aktualisieren in den nächsten Commit.
*Mit GIT Command Line Interface:

<source lang="bash">
git commit -a -m "Commit text"
</source>
Dadurch werden Hinzufügungen und Änderungen in Ihrem lokalen Branch gespeichert.

Um sie auf den GIT-Repository-Server zu pushen,

*With Eclipse: Klicken Sie mit der rechten Maustaste auf das Projekt und wählen Sie "'''Team - Push to Upstream'''".
*With GIT Command Line Interface:

<source lang="bash">
git push
</source>

Um ein Commit abzubrechen:

*Mit GIT Command Line Interface, wenn der Commit noch nicht gepusht wurde:

<source lang="bash">
git reset --soft HEAD~1
</source>

*Mit GIT Command Line Interface, wenn ein Commit bereits gepusht wurde:

<source lang="bash">
git revert IdCommit or git revert HEAD (for last commit)
</source>

Um Änderungen, die in Ihrer GIT-Instanz vorgenommen wurden, in die offizielle Dolibarr-Instanz einzubinden:

*Gehen Sie in die GitHub-Weboberfläche Ihrer geforkten Git-Instanz.
*Klicken Sie auf die kleine Schaltfläche "Create a Pull request".
*Wählen Sie den Commit aus, dessen Aufnahme Sie beantragen, und validieren Sie ihn.

=Anfrage stellen, um die Änderungen in das offizielle Projekt zu übernehmen=
Sobald Sie einen oder mehrere Commits in Ihren remote Fork-Bereich auf Github gepusht haben, können Sie das Dolibarr-Kernteam bitten, diese in das offizielle Projekt aufzunehmen.
Folgen Sie dazu dieser Anleitung: https://help.github.com/articles/creating-a-pull-request/

=Hinzufügen eines externen Commits zum aktuellen Repository=
Einige Entwickler fügen ihre Änderungen durch Commits in ihr eigenes Git-Repository hinzu, nachdem sie das Projekt geforkt haben. Wenn Sie daran interessiert sind, diese Änderungen zu erhalten, können Sie sie mit den folgenden Schritten importieren.

Hierfür benötigen Sie sowohl Eclipse als auch das GIT Command Line Interface:

*Gehen Sie zunächst in die GIT-Setup-Ansicht und klicken Sie mit der rechten Maustaste auf "'''Remotes'''" in Ihrem Eclipse-Git-Workspace und wählen Sie "'''Create a remote...'''"
*Geben Sie den Namen des entfernten Forks ein, den der Entwickler erstellt hat (in den meisten Fällen ist es das Git-Login des Entwicklers). Zum Beispiel: "'''thedevlogin'''". Wählen Sie auch "'''Configure Fetch'''".
*Geben Sie die URI des Git-Repositorys des Entwicklers ein. Zum Beispiel: '''git://github.com/thedevlogin/dolibarr.git'''. Fügen Sie auch einen refspec-Wert hinzu, um den Branch anzugeben, den Sie abrufen möchten. Zum Beispiel: '''refs/heads/master:refs/remotes/thedevlogin/master'''. Klicken Sie auf "'''Save and Fetch'''". Es wird ein neuer Eintrag in "Remote Tracking" hinzugefügt, der es ermöglicht, Commits in diesem Zweig zu lesen/zu schreiben.
Gehen Sie nun in die Kommandozeile Ihres Git-Repositorys (unter Linux ist es in den meisten Fällen '''/home/yourlogin/git/yourdolibarr''') und geben Sie den Befehl git cherry-pick ein:
<source lang="bash">
git cherry-pick -x commitid
</source>
wobei commitid der Wert der Commit-ID ist, die Sie erhalten möchten.

Sobald dies erledigt ist, gehen Sie zurück zu Eclipse und aktualisieren Sie das Projekt. Sie werden sehen, dass geänderte Dateien mit Dekoratoren erscheinen (mit Konflikten, wenn es welche gibt).

Wenn die Auswahl aufgrund von Konflikten fehlschlägt, können Sie den Versuch der Auswahl mit
<source lang="bash">
git cherry-pick --abort
</source>

=Einen Konflikt lösen=
Wenn eine Datei nach einem "Pull" als "Konflikt" markiert ist, öffnen Sie die Datei und bearbeiten Sie sie.
Rechercher la chaine "<<<<<<<<<<", vous verrez la partie de code en conflit entre "<<<<<<<<<" et ">>>>>>>>". Bearbeiten Sie die Codezeilen manuell, um das Endergebnis zu erhalten, indem Sie auch die "<<<<<<<<" et ">>>>>>>".

Klicken Sie dann mit der rechten Maustaste auf die Datei und wählen Sie " Hinzufügen".

Wenn Sie lieber alle Änderungen, die Sie an allen Dateien vorgenommen haben, vollständig rückgängig machen möchten (um Ihren Arbeitsbereich mit dem Inhalt des entfernten Repositoriums wiederherzustellen), können Sie einen Reset durchführen:

*Mit Eclipse klicken Sie mit der rechten Maustaste auf die oberste Zeile des Projekts und wählen Sie "Zurücksetzen" und dann "'''Hard'''" und dann "'''Reference - HEAD'''".
*Bei Verwendung des GIT-Befehlszeilentools erreichen Sie dies mit dem Befehl

<source lang="bash">
git reset --hard HEAD
</source>

=Taggen Sie die Quellen=
Mit den GIT-Kommandozeilenwerkzeugen:
Um ein Tag über eine Version zu erstellen:
<source lang="bash">
git tag -a -m "Release|Maintenance release x.y.z" "x.y.z"
oder
git tag -a -f -m "Beta x.y.betai" "x.y.betai_YYYYMMDD" idcommit # -f force wenn ein Tag bereits existiert, ermöglicht idcommit die Auswahl des zu taggenden Commits.
git push --tags # Pour pousser le tags sur le serveur distant
</source>

Um einen Tag zu löschen:
<source lang="bash">
git tag -d "x.y.z_YYYYMMDD"
git push origin :x.y.z_YYYYMMDD # Um die Löschung auf dem entfernten Server zu bestätigen
</source>

=Einen neue Branche erstellen=
Hier ist der Befehl, den Sie verwenden müssen, um einen neuen Zweig aus einem eigenen develop-Repository zu erstellen:
<source lang="bash">
git branch x.y
git push origin x.y
</source>

=Statistiken=
Mit den GIT-Kommandozeilenwerkzeugen:

Um die Anzahl der Änderungen zu zählen, die ein Entwickler zwischen Version x und y vorgenommen hat:

*Zuerst führen Sie "git merge-base" aus, um die ID des letzten gemeinsamen Commits zwischen x und y zu erfahren.

<source lang="bash">
git merge-base origin/3.1 origin/develop
</source>

*Dann führen Sie git log aus, um eine Liste aller Änderungen von der letzten gemeinsamen Übertragung bis zur letzten Übertragung zu erhalten.
<source lang="bash">
git log id_found_at_previous_step..HEAD
</source>

*Um die Gesamtzahl der hinzugefügten/gelöschten Zeilen zu ermitteln:
<source lang="bash">
git log --ancestry-path --numstat --pretty="%H" id_found_at_previous_step..HEAD | awk 'NF==3 {plus+=$1; minus+=$2} END {printf("+%d, -%d\n", plus, minus)}'
</source>

Zählen der endgültigen Änderungen zwischen einer Version x und y (dies unterscheidet sich von der vorherigen Zählung, da bei der vorherigen Zählung eine Änderung zweimal zu zwei verschiedenen Zeitpunkten durchgeführt werden kann, um unterschiedliche Änderungen vorzunehmen. Bei der zweiten Methode werden die Änderungen gezählt, die schließlich gefunden wurden, wenn die Änderungen beim ersten Versuch in Ordnung waren):

*Verwenden Sie die gleiche Methode wie zuvor, aber anstatt git log auszuführen, führen Sie '''git diff''' aus.

<source lang="bash">
git diff -b -M --numstat --pretty="%H" id_found_at_previous_step..HEAD | awk 'NF==3 {plus+=$1; minus+=$2} END {printf("+%d, -%d\n", plus, minus)}'
</source>

Weitere Informationen über die Verwendung von GIT erhältlich unter: [http://wiki.eclipse.org/EGit/User_Guide ici].

[[Category:Development]]

FAQ Get, update GIT Projekt Quellen

2022-09-24T10:16:11Z

Speaking services: /* Hinzufügen eines externen Commits zum aktuellen Repository */

[[en:FAQ_Get,update_GIT_project_sources]]
[[fr:FAQ_Récupérer,_mettre_à_jour_les_sources_GIT_du_projet]]
[[es:FAQ_Recuperar,_actualizar_GIT_fuentes_del_proyecto]]


[[Category:FAQ DE]]
Hier finden Sie Informationen darüber, wie Sie die Quellen des Dolibarr-Projekts erhalten können.
Es werden mehrere Methoden beschrieben, aber wir empfehlen, die auf GitHub basierende Methode zu verwenden.

 

=Letzte Version der Quellen durch tgz-Download abrufen=
Diese Methode kann auch von nicht-technischen Benutzern verwendet werden.
Sie ermöglicht es Ihnen, die Quellen des Hauptentwicklungszweigs (HEAD genannt) zu erhalten, indem Sie einfach eine Datei herunterladen: Diese Operation besteht darin, die letzte Version der Dolibarr-Dateien zu erhalten, die jede Nacht in eine tgz-Datei gepackt werden. Die Datei ist über einen Link verfügbar:

{{LinkLastSnapshot}}

Neue Dateien überschreiben alte Dateien. Der Nachteil dieser Methode ist, dass Sie das Paket jedes Mal herunterladen und dekomprimieren müssen, wenn Sie Updates erhalten möchten.

Entwickler sollten diese Methode nicht verwenden, um Quellen zu erhalten, sondern die nächste.

=Letzte Version der Quellen über einen anonymen GIT-Zugang abrufen=
Sie können diese Methode verwenden, wenn Sie keinen GIT-Zugang haben. Mit dieser Methode können Sie keine Änderungen einreichen. Wenn Sie also ein Entwickler sind, sollten Sie ein GitHub-Konto erstellen und die nächste Methode anstelle dieser Methode verwenden.

==Voraussetzungen==

*Mit Eclipse IDE

Zuerst müssen Sie eine funktionierende Installation von Eclipse haben. Das '''EGit'''-Plugin muss ebenfalls installiert worden sein.
Verwenden Sie dazu den '''Find And Install process''' im Eclipse Menü, fügen Sie die GIT update URL hinzu:
https://download.eclipse.org/egit/updates
Wählen Sie dann '''EGit''' zur Installation aus (JGit muss nicht ausgewählt werden)

*Mit der GIT-Kommandozeilen-Client-Schnittstelle

Sie müssen den GIT-Client installieren (das GIT-Befehlszeilentool wird unter Linux mit "sudo apt-get install git" installiert, für Windows ist der GIT-Client unter https://git-scm.com/download/win zu finden).

==Clone Prozess==
Geben Sie zunächst den Wert des Repositorys mit den Referenzquellen in Ihr GIT-Client-Tool ein.

*Mit Eclipse, gehen Sie in die Perspektive GIT, klicken Sie auf den Button "GIT Repository klonen". Geben Sie die GIT-URL des Projekts ein, das Sie erhalten möchten.
<source lang="ini">
git://github.com/Dolibarr/dolibarr.git (read only)
oder wenn Sie einen Fork von dolibarr github von der github-Weboberfläche erstellt haben
git@github.com:yourgitaccount/dolibarr.git (read and write access)
</source>
Ihr Eclipse-GIT-Client wird Sie auffordern, die Branches auszuwählen, an denen Sie interessiert sind. Branches, die jetzt noch nicht ausgewählt sind, können später durch einen "Fetch" aus der "Remotes"-Ansicht ausgewählt werden, aber versuchen Sie, nur den Branch auszuwählen, den Sie benötigen. Dies erspart Ihnen später Zeit und Probleme.

Hinweis: Wenn Sie sich hinter einer Firewall befinden, müssen Sie die Eclipse-Proxy-Zugangsdaten im Eclipse-Menü Fenster - Einstellungen - Allgemein - Netzwerkverbindung einstellen und die alternative URL verwenden:
<source lang="ini">
https://gitlogin:gitpassword@github.com/yourgitaccount/dolibarr.git
</source>

*Mit GIT auf der Befehlszeilenschnittstelle:

Richten Sie zunächst Ihren Git-Client ein:
<source lang="bash">
git config --global user.name "Your Name"
git config --global user.email "user@domain.com"
git config --list
</source>
Dann klonen Sie das Repository lokal:
<source lang="bash">
git://github.com/Dolibarr/dolibarr.git (nur lesen)
oder wenn Sie einen Fork von dolibarr github von der github-Weboberfläche erstellt haben
git@github.com:yourgitaccount/dolibarr.git (Lese- und Schreibzugriff)
</source>

Hinweis: Wenn Sie sich hinter einer Firewall befinden, müssen Sie Ihre Proxy-Informationen einstellen und die alternative https-URL verwenden:
<source lang="bash">
git config --global http.proxy http://proxyuser:proxypass@proxyserver:proxyport
git clone https://gitlogin:gitpassword@github.com/yourgitaccount/dolibarr.git dolibarr
</source>

Sobald dieser Schritt bestätigt ist, lädt Ihr GIT-Client alle Dateien vom entfernten GIT-Server herunter. Dies kann einige Sekunden oder Minuten dauern.

Sobald der Download abgeschlossen ist, müssen Sie wählen, an welchem Zweig Sie arbeiten möchten.

*Mit GIT auf der Befehlszeilenschnittstelle;

<source lang="bash">
git checkout develop
git checkout x.y
</source>
Dadurch wird eine lokale Branche erstellt und automatisch ein Checkout durchgeführt.

*Klicken Sie in Eclipse mit der rechten Maustaste auf "Branches - Remotes -" die Branche, die Sie lokal duplizieren möchten".
Wählen Sie " Erstelle Branch" (und markieren Sie das Kästchen "Checkout"). Dadurch wird der Inhalt der Branche dupliziert, um lokal daran zu arbeiten, und Ihr "Arbeitsverzeichnis" wird aktualisiert, um an dieser Branche zu arbeiten.

Erstellen Sie ein Eclipse-Projekt:

Wenn Sie Eclipse verwenden, erstellen Sie, sobald die Verzweigung lokal erstellt wurde, ein PHP-Projekt aus dem Assistenten, indem Sie "'''Create from existing project'''" wählen und das Verzeichnis auswählen, das Ihr lokales GIT-Repository ist (Wählen Sie nicht die Option, ein PHP-Projekt komplett neu zu erstellen).

Klicken Sie dann mit der rechten Maustaste auf das Projekt in Ihrem Eclipse-Arbeitsbereich und wählen Sie "'''Team - Share'''". Wählen Sie GIT und klicken Sie auf die Option "'''Use or create repository in parent folder of project'''".
Eine alternative Methode ist File->Import, Git->Project von Git, Wählen Sie das Git-Repository und Weiter, Assistent für neue Projekte verwenden -> Php-Projekt, geben Sie den Ordner Ihres lokalen GIT-Repositorys ein.

Dann können Sie Eclipse so einstellen, dass es nicht alle Projektdateien für seine Build-Tools (Outline Scanner, TODO Scanner, Syntax Scanner...) scannt. Dies verhindert, dass Eclipse zu langsam ist. Klicken Sie dazu mit der rechten Maustaste auf das Projekt, wählen Sie Build Path und stellen Sie es wie im folgenden Screenshot ein.

[[File:Eclipse php build path.png|240px]]

=Abrufen der letzten Version der Quellen über einen GitHub-Nutzerzugang=
==Voraussetzung==

*Mit Eclipse IDE

Sie müssen zuvor ein Konto auf GitHub (https://github.com/) erstellen und ein öffentliches RSA- oder DSA-Zertifikat in Ihr Kontoprofil hochladen.

Dann müssen Sie eine funktionierende Installation von Eclipse haben. Das '''EGit'''-Plugin muss ebenfalls installiert worden sein.
https://download.eclipse.org/egit/updates
Wählen Sie dann die Installation von '''EGit'''.
*Mit der GIT-Kommandozeilen-Schnittstelle:

Sie müssen zuvor ein Konto auf GitHub (https://github.com/) erstellen und ein öffentliches RSA- oder DSA-Zertifikat in Ihr Kontoprofil hochladen.

Dann müssen Sie den GIT-Client installieren (GIT-Kommandozeilen-Tool unter Linux mit "sudo apt-get install git" oder den GIT-Client für Windows unter https://git-scm.com/download/win).

==Fork Prozess==
Melden Sie sich bei Github mit den Login-Daten an, das Sie im vorherigen Schritt erstellt haben. Gehen Sie dann auf die Seite

https://github.com/Dolibarr/dolibarr

und klicken Sie auf die Schaltfläche "Fork".

Dadurch wird eine Kopie (ein Fork) des Projekts in Ihrem eigenen Github-Bereich erstellt. Da Sie der Besitzer dieses Forks sind, haben Sie alle Rechte, die Sie für die nächsten Schritte benötigen.

==Clone Prozess==
Dann ist der Prozess derselbe wie bei der Beschaffung von Quellen mit anonymen Zugriff.

Die für den GIT-Clone zu verwendende URL ist dieselbe:
<source lang="ini">
git@github.com:YourGitHubLogin/dolibarr.git
</source>

Beachten Sie, dass es auch eine HTTPS-URL gibt, die aber manchmal offline ist (verwenden Sie also lieber die erste, ein Link mit HTTPS ist nur erforderlich, wenn Sie sich hinter einer Firewall befinden):

<source lang="ini">
https://yourgithublogin@github.com/Dolibarr/dolibarr.git
</source>

=Update des Repository=
So aktualisieren Sie Ihren lokalen Workspace:

*Mit Eclipse IDE:

Rechtsklick auf das Eclipse-Projekt und Auswahl von "Pull".

Wenn Sie in Ihrem Eclipse-Workspace Änderungen an Dateien vorgenommen haben, die in der GIT-Remote-Referenz geändert wurden, wird Ihr GIT-Client automatisch einen Merge durchführen.

*Wenn es Konflikte gibt, wird der Merge alle Konfliktdateien als "Konflikt" markieren (siehe später, um diesen Zustand zu lösen).
*Wenn nicht, erhalten Sie alle Dateien in der neuen Version, einschließlich aller Ihrer Änderungen.

Wenn Sie bereits einige Dateien in Ihr lokales Repository übertragen haben, wird Ihr Workspace als "Zusammengeführt" markiert.
Alles was Sie tun müssen, ist ein Commit zu machen, um Ihr lokales Repository zu bestätigen, dass es sowohl Ihre Änderungen als auch die Änderungen anderer enthält.

*Mit dem GIT Command Line Client Interface:

<source lang="bash">
git pull
</source>

=Commit und Veröffentlichen von Änderungen=
Um alle Änderungen zu sehen, die Sie in Ihrem Arbeitsverzeichnis vorgenommen haben und die darauf warten, in Git hinzugefügt zu werden:

*Mit GIT Command Line Interface:

<source lang="bash">
git status
git diff subdir/filename
</source>

Um Änderungen, die Sie in Ihrem lokalen Repository vorgenommen haben, in den GIT-Index aufzunehmen, führen Sie einen commit-Befehl für diesen Index durch:

*Mit Eclipse: Klicken Sie mit der rechten Maustaste auf die zu übertragende Datei oder das Verzeichnis. Wählen Sie die Datei zum Hinzufügen/Entfernen/Aktualisieren in den nächsten Commit.
*Mit GIT Command Line Interface:

<source lang="bash">
git commit -a -m "Commit text"
</source>
Dadurch werden Hinzufügungen und Änderungen in Ihrem lokalen Branch gespeichert.

Um sie auf den GIT-Repository-Server zu pushen,

*With Eclipse: Klicken Sie mit der rechten Maustaste auf das Projekt und wählen Sie "'''Team - Push to Upstream'''".
*With GIT Command Line Interface:

<source lang="bash">
git push
</source>

Um ein Commit abzubrechen:

*Mit GIT Command Line Interface, wenn der Commit noch nicht gepusht wurde:

<source lang="bash">
git reset --soft HEAD~1
</source>

*Mit GIT Command Line Interface, wenn ein Commit bereits gepusht wurde:

<source lang="bash">
git revert IdCommit or git revert HEAD (for last commit)
</source>

Um Änderungen, die in Ihrer GIT-Instanz vorgenommen wurden, in die offizielle Dolibarr-Instanz einzubinden:

*Gehen Sie in die GitHub-Weboberfläche Ihrer geforkten Git-Instanz.
*Klicken Sie auf die kleine Schaltfläche "Create a Pull request".
*Wählen Sie den Commit aus, dessen Aufnahme Sie beantragen, und validieren Sie ihn.

=Anfrage stellen, um die Änderungen in das offizielle Projekt zu übernehmen=
Sobald Sie einen oder mehrere Commits in Ihren remote Fork-Bereich auf Github gepusht haben, können Sie das Dolibarr-Kernteam bitten, diese in das offizielle Projekt aufzunehmen.
Folgen Sie dazu dieser Anleitung: https://help.github.com/articles/creating-a-pull-request/

=Hinzufügen eines externen Commits zum aktuellen Repository=
Einige Entwickler fügen ihre Änderungen durch Commits in ihr eigenes Git-Repository hinzu, nachdem sie das Projekt geforkt haben. Wenn Sie daran interessiert sind, diese Änderungen zu erhalten, können Sie sie mit den folgenden Schritten importieren.

Hierfür benötigen Sie sowohl Eclipse als auch das GIT Command Line Interface:

*Gehen Sie zunächst in die GIT-Setup-Ansicht und klicken Sie mit der rechten Maustaste auf "'''Remotes'''" in Ihrem Eclipse-Git-Workspace und wählen Sie "'''Create a remote...'''"
*Geben Sie den Namen des entfernten Forks ein, den der Entwickler erstellt hat (in den meisten Fällen ist es das Git-Login des Entwicklers). Zum Beispiel: "'''thedevlogin'''". Wählen Sie auch "'''Configure Fetch'''".
*Geben Sie die URI des Git-Repositorys des Entwicklers ein. Zum Beispiel: '''git://github.com/thedevlogin/dolibarr.git'''. Fügen Sie auch einen refspec-Wert hinzu, um den Branch anzugeben, den Sie abrufen möchten. Zum Beispiel: '''refs/heads/master:refs/remotes/thedevlogin/master'''. Klicken Sie auf "'''Speichern und Abrufen'''". Es wird ein neuer Eintrag in "Remote Tracking" hinzugefügt, der es ermöglicht, Commits in diesem Zweig zu lesen/zu schreiben.
Gehen Sie nun in die Kommandozeile Ihres Git-Repositorys (unter Linux ist es in den meisten Fällen '''/home/yourlogin/git/yourdolibarr''') und geben Sie den Befehl git cherry-pick ein:
<source lang="bash">
git cherry-pick -x commitid
</source>
wobei commitid der Wert der Commit-ID ist, die Sie erhalten möchten.

Sobald dies erledigt ist, gehen Sie zurück zu Eclipse und aktualisieren Sie das Projekt. Sie werden sehen, dass geänderte Dateien mit Dekoratoren erscheinen (mit Konflikten, wenn es welche gibt).

Wenn die Auswahl aufgrund von Konflikten fehlschlägt, können Sie den Versuch der Auswahl mit
<source lang="bash">
git cherry-pick --abort
</source>

=Einen Konflikt lösen=
Wenn eine Datei nach einem "Pull" als "Konflikt" markiert ist, öffnen Sie die Datei und bearbeiten Sie sie.
Rechercher la chaine "<<<<<<<<<<", vous verrez la partie de code en conflit entre "<<<<<<<<<" et ">>>>>>>>". Bearbeiten Sie die Codezeilen manuell, um das Endergebnis zu erhalten, indem Sie auch die "<<<<<<<<" et ">>>>>>>".

Klicken Sie dann mit der rechten Maustaste auf die Datei und wählen Sie " Hinzufügen".

Wenn Sie lieber alle Änderungen, die Sie an allen Dateien vorgenommen haben, vollständig rückgängig machen möchten (um Ihren Arbeitsbereich mit dem Inhalt des entfernten Repositoriums wiederherzustellen), können Sie einen Reset durchführen:

*Mit Eclipse klicken Sie mit der rechten Maustaste auf die oberste Zeile des Projekts und wählen Sie "Zurücksetzen" und dann "'''Hard'''" und dann "'''Reference - HEAD'''".
*Bei Verwendung des GIT-Befehlszeilentools erreichen Sie dies mit dem Befehl

<source lang="bash">
git reset --hard HEAD
</source>

=Taggen Sie die Quellen=
Mit den GIT-Kommandozeilenwerkzeugen:
Um ein Tag über eine Version zu erstellen:
<source lang="bash">
git tag -a -m "Release|Maintenance release x.y.z" "x.y.z"
oder
git tag -a -f -m "Beta x.y.betai" "x.y.betai_YYYYMMDD" idcommit # -f force wenn ein Tag bereits existiert, ermöglicht idcommit die Auswahl des zu taggenden Commits.
git push --tags # Pour pousser le tags sur le serveur distant
</source>

Um einen Tag zu löschen:
<source lang="bash">
git tag -d "x.y.z_YYYYMMDD"
git push origin :x.y.z_YYYYMMDD # Um die Löschung auf dem entfernten Server zu bestätigen
</source>

=Einen neue Branche erstellen=
Hier ist der Befehl, den Sie verwenden müssen, um einen neuen Zweig aus einem eigenen develop-Repository zu erstellen:
<source lang="bash">
git branch x.y
git push origin x.y
</source>

=Statistiken=
Mit den GIT-Kommandozeilenwerkzeugen:

Um die Anzahl der Änderungen zu zählen, die ein Entwickler zwischen Version x und y vorgenommen hat:

*Zuerst führen Sie "git merge-base" aus, um die ID des letzten gemeinsamen Commits zwischen x und y zu erfahren.

<source lang="bash">
git merge-base origin/3.1 origin/develop
</source>

*Dann führen Sie git log aus, um eine Liste aller Änderungen von der letzten gemeinsamen Übertragung bis zur letzten Übertragung zu erhalten.
<source lang="bash">
git log id_found_at_previous_step..HEAD
</source>

*Um die Gesamtzahl der hinzugefügten/gelöschten Zeilen zu ermitteln:
<source lang="bash">
git log --ancestry-path --numstat --pretty="%H" id_found_at_previous_step..HEAD | awk 'NF==3 {plus+=$1; minus+=$2} END {printf("+%d, -%d\n", plus, minus)}'
</source>

Zählen der endgültigen Änderungen zwischen einer Version x und y (dies unterscheidet sich von der vorherigen Zählung, da bei der vorherigen Zählung eine Änderung zweimal zu zwei verschiedenen Zeitpunkten durchgeführt werden kann, um unterschiedliche Änderungen vorzunehmen. Bei der zweiten Methode werden die Änderungen gezählt, die schließlich gefunden wurden, wenn die Änderungen beim ersten Versuch in Ordnung waren):

*Verwenden Sie die gleiche Methode wie zuvor, aber anstatt git log auszuführen, führen Sie '''git diff''' aus.

<source lang="bash">
git diff -b -M --numstat --pretty="%H" id_found_at_previous_step..HEAD | awk 'NF==3 {plus+=$1; minus+=$2} END {printf("+%d, -%d\n", plus, minus)}'
</source>

Weitere Informationen über die Verwendung von GIT erhältlich unter: [http://wiki.eclipse.org/EGit/User_Guide ici].

[[Category:Development]]

FAQ Get, update GIT Projekt Quellen

2022-09-24T10:11:49Z

Speaking services: /* Add an external commit into current repository */

[[en:FAQ_Get,update_GIT_project_sources]]
[[fr:FAQ_Récupérer,_mettre_à_jour_les_sources_GIT_du_projet]]
[[es:FAQ_Recuperar,_actualizar_GIT_fuentes_del_proyecto]]


[[Category:FAQ DE]]
Hier finden Sie Informationen darüber, wie Sie die Quellen des Dolibarr-Projekts erhalten können.
Es werden mehrere Methoden beschrieben, aber wir empfehlen, die auf GitHub basierende Methode zu verwenden.

 

=Letzte Version der Quellen durch tgz-Download abrufen=
Diese Methode kann auch von nicht-technischen Benutzern verwendet werden.
Sie ermöglicht es Ihnen, die Quellen des Hauptentwicklungszweigs (HEAD genannt) zu erhalten, indem Sie einfach eine Datei herunterladen: Diese Operation besteht darin, die letzte Version der Dolibarr-Dateien zu erhalten, die jede Nacht in eine tgz-Datei gepackt werden. Die Datei ist über einen Link verfügbar:

{{LinkLastSnapshot}}

Neue Dateien überschreiben alte Dateien. Der Nachteil dieser Methode ist, dass Sie das Paket jedes Mal herunterladen und dekomprimieren müssen, wenn Sie Updates erhalten möchten.

Entwickler sollten diese Methode nicht verwenden, um Quellen zu erhalten, sondern die nächste.

=Letzte Version der Quellen über einen anonymen GIT-Zugang abrufen=
Sie können diese Methode verwenden, wenn Sie keinen GIT-Zugang haben. Mit dieser Methode können Sie keine Änderungen einreichen. Wenn Sie also ein Entwickler sind, sollten Sie ein GitHub-Konto erstellen und die nächste Methode anstelle dieser Methode verwenden.

==Voraussetzungen==

*Mit Eclipse IDE

Zuerst müssen Sie eine funktionierende Installation von Eclipse haben. Das '''EGit'''-Plugin muss ebenfalls installiert worden sein.
Verwenden Sie dazu den '''Find And Install process''' im Eclipse Menü, fügen Sie die GIT update URL hinzu:
https://download.eclipse.org/egit/updates
Wählen Sie dann '''EGit''' zur Installation aus (JGit muss nicht ausgewählt werden)

*Mit der GIT-Kommandozeilen-Client-Schnittstelle

Sie müssen den GIT-Client installieren (das GIT-Befehlszeilentool wird unter Linux mit "sudo apt-get install git" installiert, für Windows ist der GIT-Client unter https://git-scm.com/download/win zu finden).

==Clone Prozess==
Geben Sie zunächst den Wert des Repositorys mit den Referenzquellen in Ihr GIT-Client-Tool ein.

*Mit Eclipse, gehen Sie in die Perspektive GIT, klicken Sie auf den Button "GIT Repository klonen". Geben Sie die GIT-URL des Projekts ein, das Sie erhalten möchten.
<source lang="ini">
git://github.com/Dolibarr/dolibarr.git (read only)
oder wenn Sie einen Fork von dolibarr github von der github-Weboberfläche erstellt haben
git@github.com:yourgitaccount/dolibarr.git (read and write access)
</source>
Ihr Eclipse-GIT-Client wird Sie auffordern, die Branches auszuwählen, an denen Sie interessiert sind. Branches, die jetzt noch nicht ausgewählt sind, können später durch einen "Fetch" aus der "Remotes"-Ansicht ausgewählt werden, aber versuchen Sie, nur den Branch auszuwählen, den Sie benötigen. Dies erspart Ihnen später Zeit und Probleme.

Hinweis: Wenn Sie sich hinter einer Firewall befinden, müssen Sie die Eclipse-Proxy-Zugangsdaten im Eclipse-Menü Fenster - Einstellungen - Allgemein - Netzwerkverbindung einstellen und die alternative URL verwenden:
<source lang="ini">
https://gitlogin:gitpassword@github.com/yourgitaccount/dolibarr.git
</source>

*Mit GIT auf der Befehlszeilenschnittstelle:

Richten Sie zunächst Ihren Git-Client ein:
<source lang="bash">
git config --global user.name "Your Name"
git config --global user.email "user@domain.com"
git config --list
</source>
Dann klonen Sie das Repository lokal:
<source lang="bash">
git://github.com/Dolibarr/dolibarr.git (nur lesen)
oder wenn Sie einen Fork von dolibarr github von der github-Weboberfläche erstellt haben
git@github.com:yourgitaccount/dolibarr.git (Lese- und Schreibzugriff)
</source>

Hinweis: Wenn Sie sich hinter einer Firewall befinden, müssen Sie Ihre Proxy-Informationen einstellen und die alternative https-URL verwenden:
<source lang="bash">
git config --global http.proxy http://proxyuser:proxypass@proxyserver:proxyport
git clone https://gitlogin:gitpassword@github.com/yourgitaccount/dolibarr.git dolibarr
</source>

Sobald dieser Schritt bestätigt ist, lädt Ihr GIT-Client alle Dateien vom entfernten GIT-Server herunter. Dies kann einige Sekunden oder Minuten dauern.

Sobald der Download abgeschlossen ist, müssen Sie wählen, an welchem Zweig Sie arbeiten möchten.

*Mit GIT auf der Befehlszeilenschnittstelle;

<source lang="bash">
git checkout develop
git checkout x.y
</source>
Dadurch wird eine lokale Branche erstellt und automatisch ein Checkout durchgeführt.

*Klicken Sie in Eclipse mit der rechten Maustaste auf "Branches - Remotes -" die Branche, die Sie lokal duplizieren möchten".
Wählen Sie " Erstelle Branch" (und markieren Sie das Kästchen "Checkout"). Dadurch wird der Inhalt der Branche dupliziert, um lokal daran zu arbeiten, und Ihr "Arbeitsverzeichnis" wird aktualisiert, um an dieser Branche zu arbeiten.

Erstellen Sie ein Eclipse-Projekt:

Wenn Sie Eclipse verwenden, erstellen Sie, sobald die Verzweigung lokal erstellt wurde, ein PHP-Projekt aus dem Assistenten, indem Sie "'''Create from existing project'''" wählen und das Verzeichnis auswählen, das Ihr lokales GIT-Repository ist (Wählen Sie nicht die Option, ein PHP-Projekt komplett neu zu erstellen).

Klicken Sie dann mit der rechten Maustaste auf das Projekt in Ihrem Eclipse-Arbeitsbereich und wählen Sie "'''Team - Share'''". Wählen Sie GIT und klicken Sie auf die Option "'''Use or create repository in parent folder of project'''".
Eine alternative Methode ist File->Import, Git->Project von Git, Wählen Sie das Git-Repository und Weiter, Assistent für neue Projekte verwenden -> Php-Projekt, geben Sie den Ordner Ihres lokalen GIT-Repositorys ein.

Dann können Sie Eclipse so einstellen, dass es nicht alle Projektdateien für seine Build-Tools (Outline Scanner, TODO Scanner, Syntax Scanner...) scannt. Dies verhindert, dass Eclipse zu langsam ist. Klicken Sie dazu mit der rechten Maustaste auf das Projekt, wählen Sie Build Path und stellen Sie es wie im folgenden Screenshot ein.

[[File:Eclipse php build path.png|240px]]

=Abrufen der letzten Version der Quellen über einen GitHub-Nutzerzugang=
==Voraussetzung==

*Mit Eclipse IDE

Sie müssen zuvor ein Konto auf GitHub (https://github.com/) erstellen und ein öffentliches RSA- oder DSA-Zertifikat in Ihr Kontoprofil hochladen.

Dann müssen Sie eine funktionierende Installation von Eclipse haben. Das '''EGit'''-Plugin muss ebenfalls installiert worden sein.
https://download.eclipse.org/egit/updates
Wählen Sie dann die Installation von '''EGit'''.
*Mit der GIT-Kommandozeilen-Schnittstelle:

Sie müssen zuvor ein Konto auf GitHub (https://github.com/) erstellen und ein öffentliches RSA- oder DSA-Zertifikat in Ihr Kontoprofil hochladen.

Dann müssen Sie den GIT-Client installieren (GIT-Kommandozeilen-Tool unter Linux mit "sudo apt-get install git" oder den GIT-Client für Windows unter https://git-scm.com/download/win).

==Fork Prozess==
Melden Sie sich bei Github mit den Login-Daten an, das Sie im vorherigen Schritt erstellt haben. Gehen Sie dann auf die Seite

https://github.com/Dolibarr/dolibarr

und klicken Sie auf die Schaltfläche "Fork".

Dadurch wird eine Kopie (ein Fork) des Projekts in Ihrem eigenen Github-Bereich erstellt. Da Sie der Besitzer dieses Forks sind, haben Sie alle Rechte, die Sie für die nächsten Schritte benötigen.

==Clone Prozess==
Dann ist der Prozess derselbe wie bei der Beschaffung von Quellen mit anonymen Zugriff.

Die für den GIT-Clone zu verwendende URL ist dieselbe:
<source lang="ini">
git@github.com:YourGitHubLogin/dolibarr.git
</source>

Beachten Sie, dass es auch eine HTTPS-URL gibt, die aber manchmal offline ist (verwenden Sie also lieber die erste, ein Link mit HTTPS ist nur erforderlich, wenn Sie sich hinter einer Firewall befinden):

<source lang="ini">
https://yourgithublogin@github.com/Dolibarr/dolibarr.git
</source>

=Update des Repository=
So aktualisieren Sie Ihren lokalen Workspace:

*Mit Eclipse IDE:

Rechtsklick auf das Eclipse-Projekt und Auswahl von "Pull".

Wenn Sie in Ihrem Eclipse-Workspace Änderungen an Dateien vorgenommen haben, die in der GIT-Remote-Referenz geändert wurden, wird Ihr GIT-Client automatisch einen Merge durchführen.

*Wenn es Konflikte gibt, wird der Merge alle Konfliktdateien als "Konflikt" markieren (siehe später, um diesen Zustand zu lösen).
*Wenn nicht, erhalten Sie alle Dateien in der neuen Version, einschließlich aller Ihrer Änderungen.

Wenn Sie bereits einige Dateien in Ihr lokales Repository übertragen haben, wird Ihr Workspace als "Zusammengeführt" markiert.
Alles was Sie tun müssen, ist ein Commit zu machen, um Ihr lokales Repository zu bestätigen, dass es sowohl Ihre Änderungen als auch die Änderungen anderer enthält.

*Mit dem GIT Command Line Client Interface:

<source lang="bash">
git pull
</source>

=Commit und Veröffentlichen von Änderungen=
Um alle Änderungen zu sehen, die Sie in Ihrem Arbeitsverzeichnis vorgenommen haben und die darauf warten, in Git hinzugefügt zu werden:

*Mit GIT Command Line Interface:

<source lang="bash">
git status
git diff subdir/filename
</source>

Um Änderungen, die Sie in Ihrem lokalen Repository vorgenommen haben, in den GIT-Index aufzunehmen, führen Sie einen commit-Befehl für diesen Index durch:

*Mit Eclipse: Klicken Sie mit der rechten Maustaste auf die zu übertragende Datei oder das Verzeichnis. Wählen Sie die Datei zum Hinzufügen/Entfernen/Aktualisieren in den nächsten Commit.
*Mit GIT Command Line Interface:

<source lang="bash">
git commit -a -m "Commit text"
</source>
Dadurch werden Hinzufügungen und Änderungen in Ihrem lokalen Branch gespeichert.

Um sie auf den GIT-Repository-Server zu pushen,

*With Eclipse: Klicken Sie mit der rechten Maustaste auf das Projekt und wählen Sie "'''Team - Push to Upstream'''".
*With GIT Command Line Interface:

<source lang="bash">
git push
</source>

Um ein Commit abzubrechen:

*Mit GIT Command Line Interface, wenn der Commit noch nicht gepusht wurde:

<source lang="bash">
git reset --soft HEAD~1
</source>

*Mit GIT Command Line Interface, wenn ein Commit bereits gepusht wurde:

<source lang="bash">
git revert IdCommit or git revert HEAD (for last commit)
</source>

Um Änderungen, die in Ihrer GIT-Instanz vorgenommen wurden, in die offizielle Dolibarr-Instanz einzubinden:

*Gehen Sie in die GitHub-Weboberfläche Ihrer geforkten Git-Instanz.
*Klicken Sie auf die kleine Schaltfläche "Create a Pull request".
*Wählen Sie den Commit aus, dessen Aufnahme Sie beantragen, und validieren Sie ihn.

=Anfrage stellen, um die Änderungen in das offizielle Projekt zu übernehmen=
Sobald Sie einen oder mehrere Commits in Ihren remote Fork-Bereich auf Github gepusht haben, können Sie das Dolibarr-Kernteam bitten, diese in das offizielle Projekt aufzunehmen.
Folgen Sie dazu dieser Anleitung: https://help.github.com/articles/creating-a-pull-request/

=Hinzufügen eines externen Commits zum aktuellen Repository=
Some developers may work and do commit into their own Git repository after forking the project. If you are interesting into getting this changes, you can import them with the following steps.

Einige Entwickler fügen ihre Änderungen durch Commits in ihr eigenes Git-Repository hinzu, nachdem sie das Projekt geforkt haben. Wenn Sie daran interessiert sind, diese Änderungen zu erhalten, können Sie sie mit den folgenden Schritten importieren.

You need both Eclipse and GIT Command Line interface to achieve this:

*First, go into GIT setup view and right click on "'''Remotes'''" of your Eclipse Git working space and choose "'''Create a remote...'''"
*Type name or remote fork the developer has create (in most cases, it's developer Git login). For example: "'''thedevlogin'''". Choose also "'''Configure Fetch'''".
*Type URI of Git repository of developer. For example: '''git://github.com/thedevlogin/dolibarr.git'''. Also add a refspec value to declare the branch you want to get. For example: '''refs/heads/master:refs/remotes/thedevlogin/master'''. Click "'''Save and Fetch'''". A new entry will be added into "Remote Tracking" making possible to read/get commits done into this branch.
Gehen Sie nun in die Kommandozeile Ihres Git-Repositorys (unter Linux ist es in den meisten Fällen '''/home/yourlogin/git/yourdolibarr''') und geben Sie den Befehl git cherry-pick ein:
<source lang="bash">
git cherry-pick -x commitid
</source>
wobei commitid der Wert der Commit-ID ist, die Sie erhalten möchten.

Sobald dies erledigt ist, gehen Sie zurück zu Eclipse und aktualisieren Sie das Projekt. Sie werden sehen, dass geänderte Dateien mit Dekoratoren erscheinen (mit Konflikten, wenn es welche gibt).

Wenn die Auswahl aufgrund von Konflikten fehlschlägt, können Sie den Versuch der Auswahl mit
<source lang="bash">
git cherry-pick --abort
</source>

=Einen Konflikt lösen=
Wenn eine Datei nach einem "Pull" als "Konflikt" markiert ist, öffnen Sie die Datei und bearbeiten Sie sie.
Rechercher la chaine "<<<<<<<<<<", vous verrez la partie de code en conflit entre "<<<<<<<<<" et ">>>>>>>>". Bearbeiten Sie die Codezeilen manuell, um das Endergebnis zu erhalten, indem Sie auch die "<<<<<<<<" et ">>>>>>>".

Klicken Sie dann mit der rechten Maustaste auf die Datei und wählen Sie " Hinzufügen".

Wenn Sie lieber alle Änderungen, die Sie an allen Dateien vorgenommen haben, vollständig rückgängig machen möchten (um Ihren Arbeitsbereich mit dem Inhalt des entfernten Repositoriums wiederherzustellen), können Sie einen Reset durchführen:

*Mit Eclipse klicken Sie mit der rechten Maustaste auf die oberste Zeile des Projekts und wählen Sie "Zurücksetzen" und dann "'''Hard'''" und dann "'''Reference - HEAD'''".
*Bei Verwendung des GIT-Befehlszeilentools erreichen Sie dies mit dem Befehl

<source lang="bash">
git reset --hard HEAD
</source>

=Taggen Sie die Quellen=
Mit den GIT-Kommandozeilenwerkzeugen:
Um ein Tag über eine Version zu erstellen:
<source lang="bash">
git tag -a -m "Release|Maintenance release x.y.z" "x.y.z"
oder
git tag -a -f -m "Beta x.y.betai" "x.y.betai_YYYYMMDD" idcommit # -f force wenn ein Tag bereits existiert, ermöglicht idcommit die Auswahl des zu taggenden Commits.
git push --tags # Pour pousser le tags sur le serveur distant
</source>

Um einen Tag zu löschen:
<source lang="bash">
git tag -d "x.y.z_YYYYMMDD"
git push origin :x.y.z_YYYYMMDD # Um die Löschung auf dem entfernten Server zu bestätigen
</source>

=Einen neue Branche erstellen=
Hier ist der Befehl, den Sie verwenden müssen, um einen neuen Zweig aus einem eigenen develop-Repository zu erstellen:
<source lang="bash">
git branch x.y
git push origin x.y
</source>

=Statistiken=
Mit den GIT-Kommandozeilenwerkzeugen:

Um die Anzahl der Änderungen zu zählen, die ein Entwickler zwischen Version x und y vorgenommen hat:

*Zuerst führen Sie "git merge-base" aus, um die ID des letzten gemeinsamen Commits zwischen x und y zu erfahren.

<source lang="bash">
git merge-base origin/3.1 origin/develop
</source>

*Dann führen Sie git log aus, um eine Liste aller Änderungen von der letzten gemeinsamen Übertragung bis zur letzten Übertragung zu erhalten.
<source lang="bash">
git log id_found_at_previous_step..HEAD
</source>

*Um die Gesamtzahl der hinzugefügten/gelöschten Zeilen zu ermitteln:
<source lang="bash">
git log --ancestry-path --numstat --pretty="%H" id_found_at_previous_step..HEAD | awk 'NF==3 {plus+=$1; minus+=$2} END {printf("+%d, -%d\n", plus, minus)}'
</source>

Zählen der endgültigen Änderungen zwischen einer Version x und y (dies unterscheidet sich von der vorherigen Zählung, da bei der vorherigen Zählung eine Änderung zweimal zu zwei verschiedenen Zeitpunkten durchgeführt werden kann, um unterschiedliche Änderungen vorzunehmen. Bei der zweiten Methode werden die Änderungen gezählt, die schließlich gefunden wurden, wenn die Änderungen beim ersten Versuch in Ordnung waren):

*Verwenden Sie die gleiche Methode wie zuvor, aber anstatt git log auszuführen, führen Sie '''git diff''' aus.

<source lang="bash">
git diff -b -M --numstat --pretty="%H" id_found_at_previous_step..HEAD | awk 'NF==3 {plus+=$1; minus+=$2} END {printf("+%d, -%d\n", plus, minus)}'
</source>

Weitere Informationen über die Verwendung von GIT erhältlich unter: [http://wiki.eclipse.org/EGit/User_Guide ici].

[[Category:Development]]

FAQ Get, update GIT Projekt Quellen

2022-09-24T10:07:28Z

Speaking services: /* Ask official project to include your changes */

[[en:FAQ_Get,update_GIT_project_sources]]
[[fr:FAQ_Récupérer,_mettre_à_jour_les_sources_GIT_du_projet]]
[[es:FAQ_Recuperar,_actualizar_GIT_fuentes_del_proyecto]]


[[Category:FAQ DE]]
Hier finden Sie Informationen darüber, wie Sie die Quellen des Dolibarr-Projekts erhalten können.
Es werden mehrere Methoden beschrieben, aber wir empfehlen, die auf GitHub basierende Methode zu verwenden.

 

=Letzte Version der Quellen durch tgz-Download abrufen=
Diese Methode kann auch von nicht-technischen Benutzern verwendet werden.
Sie ermöglicht es Ihnen, die Quellen des Hauptentwicklungszweigs (HEAD genannt) zu erhalten, indem Sie einfach eine Datei herunterladen: Diese Operation besteht darin, die letzte Version der Dolibarr-Dateien zu erhalten, die jede Nacht in eine tgz-Datei gepackt werden. Die Datei ist über einen Link verfügbar:

{{LinkLastSnapshot}}

Neue Dateien überschreiben alte Dateien. Der Nachteil dieser Methode ist, dass Sie das Paket jedes Mal herunterladen und dekomprimieren müssen, wenn Sie Updates erhalten möchten.

Entwickler sollten diese Methode nicht verwenden, um Quellen zu erhalten, sondern die nächste.

=Letzte Version der Quellen über einen anonymen GIT-Zugang abrufen=
Sie können diese Methode verwenden, wenn Sie keinen GIT-Zugang haben. Mit dieser Methode können Sie keine Änderungen einreichen. Wenn Sie also ein Entwickler sind, sollten Sie ein GitHub-Konto erstellen und die nächste Methode anstelle dieser Methode verwenden.

==Voraussetzungen==

*Mit Eclipse IDE

Zuerst müssen Sie eine funktionierende Installation von Eclipse haben. Das '''EGit'''-Plugin muss ebenfalls installiert worden sein.
Verwenden Sie dazu den '''Find And Install process''' im Eclipse Menü, fügen Sie die GIT update URL hinzu:
https://download.eclipse.org/egit/updates
Wählen Sie dann '''EGit''' zur Installation aus (JGit muss nicht ausgewählt werden)

*Mit der GIT-Kommandozeilen-Client-Schnittstelle

Sie müssen den GIT-Client installieren (das GIT-Befehlszeilentool wird unter Linux mit "sudo apt-get install git" installiert, für Windows ist der GIT-Client unter https://git-scm.com/download/win zu finden).

==Clone Prozess==
Geben Sie zunächst den Wert des Repositorys mit den Referenzquellen in Ihr GIT-Client-Tool ein.

*Mit Eclipse, gehen Sie in die Perspektive GIT, klicken Sie auf den Button "GIT Repository klonen". Geben Sie die GIT-URL des Projekts ein, das Sie erhalten möchten.
<source lang="ini">
git://github.com/Dolibarr/dolibarr.git (read only)
oder wenn Sie einen Fork von dolibarr github von der github-Weboberfläche erstellt haben
git@github.com:yourgitaccount/dolibarr.git (read and write access)
</source>
Ihr Eclipse-GIT-Client wird Sie auffordern, die Branches auszuwählen, an denen Sie interessiert sind. Branches, die jetzt noch nicht ausgewählt sind, können später durch einen "Fetch" aus der "Remotes"-Ansicht ausgewählt werden, aber versuchen Sie, nur den Branch auszuwählen, den Sie benötigen. Dies erspart Ihnen später Zeit und Probleme.

Hinweis: Wenn Sie sich hinter einer Firewall befinden, müssen Sie die Eclipse-Proxy-Zugangsdaten im Eclipse-Menü Fenster - Einstellungen - Allgemein - Netzwerkverbindung einstellen und die alternative URL verwenden:
<source lang="ini">
https://gitlogin:gitpassword@github.com/yourgitaccount/dolibarr.git
</source>

*Mit GIT auf der Befehlszeilenschnittstelle:

Richten Sie zunächst Ihren Git-Client ein:
<source lang="bash">
git config --global user.name "Your Name"
git config --global user.email "user@domain.com"
git config --list
</source>
Dann klonen Sie das Repository lokal:
<source lang="bash">
git://github.com/Dolibarr/dolibarr.git (nur lesen)
oder wenn Sie einen Fork von dolibarr github von der github-Weboberfläche erstellt haben
git@github.com:yourgitaccount/dolibarr.git (Lese- und Schreibzugriff)
</source>

Hinweis: Wenn Sie sich hinter einer Firewall befinden, müssen Sie Ihre Proxy-Informationen einstellen und die alternative https-URL verwenden:
<source lang="bash">
git config --global http.proxy http://proxyuser:proxypass@proxyserver:proxyport
git clone https://gitlogin:gitpassword@github.com/yourgitaccount/dolibarr.git dolibarr
</source>

Sobald dieser Schritt bestätigt ist, lädt Ihr GIT-Client alle Dateien vom entfernten GIT-Server herunter. Dies kann einige Sekunden oder Minuten dauern.

Sobald der Download abgeschlossen ist, müssen Sie wählen, an welchem Zweig Sie arbeiten möchten.

*Mit GIT auf der Befehlszeilenschnittstelle;

<source lang="bash">
git checkout develop
git checkout x.y
</source>
Dadurch wird eine lokale Branche erstellt und automatisch ein Checkout durchgeführt.

*Klicken Sie in Eclipse mit der rechten Maustaste auf "Branches - Remotes -" die Branche, die Sie lokal duplizieren möchten".
Wählen Sie " Erstelle Branch" (und markieren Sie das Kästchen "Checkout"). Dadurch wird der Inhalt der Branche dupliziert, um lokal daran zu arbeiten, und Ihr "Arbeitsverzeichnis" wird aktualisiert, um an dieser Branche zu arbeiten.

Erstellen Sie ein Eclipse-Projekt:

Wenn Sie Eclipse verwenden, erstellen Sie, sobald die Verzweigung lokal erstellt wurde, ein PHP-Projekt aus dem Assistenten, indem Sie "'''Create from existing project'''" wählen und das Verzeichnis auswählen, das Ihr lokales GIT-Repository ist (Wählen Sie nicht die Option, ein PHP-Projekt komplett neu zu erstellen).

Klicken Sie dann mit der rechten Maustaste auf das Projekt in Ihrem Eclipse-Arbeitsbereich und wählen Sie "'''Team - Share'''". Wählen Sie GIT und klicken Sie auf die Option "'''Use or create repository in parent folder of project'''".
Eine alternative Methode ist File->Import, Git->Project von Git, Wählen Sie das Git-Repository und Weiter, Assistent für neue Projekte verwenden -> Php-Projekt, geben Sie den Ordner Ihres lokalen GIT-Repositorys ein.

Dann können Sie Eclipse so einstellen, dass es nicht alle Projektdateien für seine Build-Tools (Outline Scanner, TODO Scanner, Syntax Scanner...) scannt. Dies verhindert, dass Eclipse zu langsam ist. Klicken Sie dazu mit der rechten Maustaste auf das Projekt, wählen Sie Build Path und stellen Sie es wie im folgenden Screenshot ein.

[[File:Eclipse php build path.png|240px]]

=Abrufen der letzten Version der Quellen über einen GitHub-Nutzerzugang=
==Voraussetzung==

*Mit Eclipse IDE

Sie müssen zuvor ein Konto auf GitHub (https://github.com/) erstellen und ein öffentliches RSA- oder DSA-Zertifikat in Ihr Kontoprofil hochladen.

Dann müssen Sie eine funktionierende Installation von Eclipse haben. Das '''EGit'''-Plugin muss ebenfalls installiert worden sein.
https://download.eclipse.org/egit/updates
Wählen Sie dann die Installation von '''EGit'''.
*Mit der GIT-Kommandozeilen-Schnittstelle:

Sie müssen zuvor ein Konto auf GitHub (https://github.com/) erstellen und ein öffentliches RSA- oder DSA-Zertifikat in Ihr Kontoprofil hochladen.

Dann müssen Sie den GIT-Client installieren (GIT-Kommandozeilen-Tool unter Linux mit "sudo apt-get install git" oder den GIT-Client für Windows unter https://git-scm.com/download/win).

==Fork Prozess==
Melden Sie sich bei Github mit den Login-Daten an, das Sie im vorherigen Schritt erstellt haben. Gehen Sie dann auf die Seite

https://github.com/Dolibarr/dolibarr

und klicken Sie auf die Schaltfläche "Fork".

Dadurch wird eine Kopie (ein Fork) des Projekts in Ihrem eigenen Github-Bereich erstellt. Da Sie der Besitzer dieses Forks sind, haben Sie alle Rechte, die Sie für die nächsten Schritte benötigen.

==Clone Prozess==
Dann ist der Prozess derselbe wie bei der Beschaffung von Quellen mit anonymen Zugriff.

Die für den GIT-Clone zu verwendende URL ist dieselbe:
<source lang="ini">
git@github.com:YourGitHubLogin/dolibarr.git
</source>

Beachten Sie, dass es auch eine HTTPS-URL gibt, die aber manchmal offline ist (verwenden Sie also lieber die erste, ein Link mit HTTPS ist nur erforderlich, wenn Sie sich hinter einer Firewall befinden):

<source lang="ini">
https://yourgithublogin@github.com/Dolibarr/dolibarr.git
</source>

=Update des Repository=
So aktualisieren Sie Ihren lokalen Workspace:

*Mit Eclipse IDE:

Rechtsklick auf das Eclipse-Projekt und Auswahl von "Pull".

Wenn Sie in Ihrem Eclipse-Workspace Änderungen an Dateien vorgenommen haben, die in der GIT-Remote-Referenz geändert wurden, wird Ihr GIT-Client automatisch einen Merge durchführen.

*Wenn es Konflikte gibt, wird der Merge alle Konfliktdateien als "Konflikt" markieren (siehe später, um diesen Zustand zu lösen).
*Wenn nicht, erhalten Sie alle Dateien in der neuen Version, einschließlich aller Ihrer Änderungen.

Wenn Sie bereits einige Dateien in Ihr lokales Repository übertragen haben, wird Ihr Workspace als "Zusammengeführt" markiert.
Alles was Sie tun müssen, ist ein Commit zu machen, um Ihr lokales Repository zu bestätigen, dass es sowohl Ihre Änderungen als auch die Änderungen anderer enthält.

*Mit dem GIT Command Line Client Interface:

<source lang="bash">
git pull
</source>

=Commit und Veröffentlichen von Änderungen=
Um alle Änderungen zu sehen, die Sie in Ihrem Arbeitsverzeichnis vorgenommen haben und die darauf warten, in Git hinzugefügt zu werden:

*Mit GIT Command Line Interface:

<source lang="bash">
git status
git diff subdir/filename
</source>

Um Änderungen, die Sie in Ihrem lokalen Repository vorgenommen haben, in den GIT-Index aufzunehmen, führen Sie einen commit-Befehl für diesen Index durch:

*Mit Eclipse: Klicken Sie mit der rechten Maustaste auf die zu übertragende Datei oder das Verzeichnis. Wählen Sie die Datei zum Hinzufügen/Entfernen/Aktualisieren in den nächsten Commit.
*Mit GIT Command Line Interface:

<source lang="bash">
git commit -a -m "Commit text"
</source>
Dadurch werden Hinzufügungen und Änderungen in Ihrem lokalen Branch gespeichert.

Um sie auf den GIT-Repository-Server zu pushen,

*With Eclipse: Klicken Sie mit der rechten Maustaste auf das Projekt und wählen Sie "'''Team - Push to Upstream'''".
*With GIT Command Line Interface:

<source lang="bash">
git push
</source>

Um ein Commit abzubrechen:

*Mit GIT Command Line Interface, wenn der Commit noch nicht gepusht wurde:

<source lang="bash">
git reset --soft HEAD~1
</source>

*Mit GIT Command Line Interface, wenn ein Commit bereits gepusht wurde:

<source lang="bash">
git revert IdCommit or git revert HEAD (for last commit)
</source>

Um Änderungen, die in Ihrer GIT-Instanz vorgenommen wurden, in die offizielle Dolibarr-Instanz einzubinden:

*Gehen Sie in die GitHub-Weboberfläche Ihrer geforkten Git-Instanz.
*Klicken Sie auf die kleine Schaltfläche "Create a Pull request".
*Wählen Sie den Commit aus, dessen Aufnahme Sie beantragen, und validieren Sie ihn.

=Anfrage stellen, um die Änderungen in das offizielle Projekt zu übernehmen=
Sobald Sie einen oder mehrere Commits in Ihren remote Fork-Bereich auf Github gepusht haben, können Sie das Dolibarr-Kernteam bitten, diese in das offizielle Projekt aufzunehmen.
Folgen Sie dazu dieser Anleitung: https://help.github.com/articles/creating-a-pull-request/

=Add an external commit into current repository=
Some developers may work and do commit into their own Git repository after forking the project. If you are interesting into getting this changes, you can import them with the following steps.

You need both Eclipse and GIT Command Line interface to achieve this:

*First, go into GIT setup view and right click on "'''Remotes'''" of your Eclipse Git working space and choose "'''Create a remote...'''"
*Type name or remote fork the developer has create (in most cases, it's developer Git login). For example: "'''thedevlogin'''". Choose also "'''Configure Fetch'''".
*Type URI of Git repository of developer. For example: '''git://github.com/thedevlogin/dolibarr.git'''. Also add a refspec value to declare the branch you want to get. For example: '''refs/heads/master:refs/remotes/thedevlogin/master'''. Click "'''Save and Fetch'''". A new entry will be added into "Remote Tracking" making possible to read/get commits done into this branch.
Gehen Sie nun in die Kommandozeile Ihres Git-Repositorys (unter Linux ist es in den meisten Fällen '''/home/yourlogin/git/yourdolibarr''') und geben Sie den Befehl git cherry-pick ein:
<source lang="bash">
git cherry-pick -x commitid
</source>
wobei commitid der Wert der Commit-ID ist, die Sie erhalten möchten.

Sobald dies erledigt ist, gehen Sie zurück zu Eclipse und aktualisieren Sie das Projekt. Sie werden sehen, dass geänderte Dateien mit Dekoratoren erscheinen (mit Konflikten, wenn es welche gibt).

Wenn die Auswahl aufgrund von Konflikten fehlschlägt, können Sie den Versuch der Auswahl mit
<source lang="bash">
git cherry-pick --abort
</source>

=Einen Konflikt lösen=
Wenn eine Datei nach einem "Pull" als "Konflikt" markiert ist, öffnen Sie die Datei und bearbeiten Sie sie.
Rechercher la chaine "<<<<<<<<<<", vous verrez la partie de code en conflit entre "<<<<<<<<<" et ">>>>>>>>". Bearbeiten Sie die Codezeilen manuell, um das Endergebnis zu erhalten, indem Sie auch die "<<<<<<<<" et ">>>>>>>".

Klicken Sie dann mit der rechten Maustaste auf die Datei und wählen Sie " Hinzufügen".

Wenn Sie lieber alle Änderungen, die Sie an allen Dateien vorgenommen haben, vollständig rückgängig machen möchten (um Ihren Arbeitsbereich mit dem Inhalt des entfernten Repositoriums wiederherzustellen), können Sie einen Reset durchführen:

*Mit Eclipse klicken Sie mit der rechten Maustaste auf die oberste Zeile des Projekts und wählen Sie "Zurücksetzen" und dann "'''Hard'''" und dann "'''Reference - HEAD'''".
*Bei Verwendung des GIT-Befehlszeilentools erreichen Sie dies mit dem Befehl

<source lang="bash">
git reset --hard HEAD
</source>

=Taggen Sie die Quellen=
Mit den GIT-Kommandozeilenwerkzeugen:
Um ein Tag über eine Version zu erstellen:
<source lang="bash">
git tag -a -m "Release|Maintenance release x.y.z" "x.y.z"
oder
git tag -a -f -m "Beta x.y.betai" "x.y.betai_YYYYMMDD" idcommit # -f force wenn ein Tag bereits existiert, ermöglicht idcommit die Auswahl des zu taggenden Commits.
git push --tags # Pour pousser le tags sur le serveur distant
</source>

Um einen Tag zu löschen:
<source lang="bash">
git tag -d "x.y.z_YYYYMMDD"
git push origin :x.y.z_YYYYMMDD # Um die Löschung auf dem entfernten Server zu bestätigen
</source>

=Einen neue Branche erstellen=
Hier ist der Befehl, den Sie verwenden müssen, um einen neuen Zweig aus einem eigenen develop-Repository zu erstellen:
<source lang="bash">
git branch x.y
git push origin x.y
</source>

=Statistiken=
Mit den GIT-Kommandozeilenwerkzeugen:

Um die Anzahl der Änderungen zu zählen, die ein Entwickler zwischen Version x und y vorgenommen hat:

*Zuerst führen Sie "git merge-base" aus, um die ID des letzten gemeinsamen Commits zwischen x und y zu erfahren.

<source lang="bash">
git merge-base origin/3.1 origin/develop
</source>

*Dann führen Sie git log aus, um eine Liste aller Änderungen von der letzten gemeinsamen Übertragung bis zur letzten Übertragung zu erhalten.
<source lang="bash">
git log id_found_at_previous_step..HEAD
</source>

*Um die Gesamtzahl der hinzugefügten/gelöschten Zeilen zu ermitteln:
<source lang="bash">
git log --ancestry-path --numstat --pretty="%H" id_found_at_previous_step..HEAD | awk 'NF==3 {plus+=$1; minus+=$2} END {printf("+%d, -%d\n", plus, minus)}'
</source>

Zählen der endgültigen Änderungen zwischen einer Version x und y (dies unterscheidet sich von der vorherigen Zählung, da bei der vorherigen Zählung eine Änderung zweimal zu zwei verschiedenen Zeitpunkten durchgeführt werden kann, um unterschiedliche Änderungen vorzunehmen. Bei der zweiten Methode werden die Änderungen gezählt, die schließlich gefunden wurden, wenn die Änderungen beim ersten Versuch in Ordnung waren):

*Verwenden Sie die gleiche Methode wie zuvor, aber anstatt git log auszuführen, führen Sie '''git diff''' aus.

<source lang="bash">
git diff -b -M --numstat --pretty="%H" id_found_at_previous_step..HEAD | awk 'NF==3 {plus+=$1; minus+=$2} END {printf("+%d, -%d\n", plus, minus)}'
</source>

Weitere Informationen über die Verwendung von GIT erhältlich unter: [http://wiki.eclipse.org/EGit/User_Guide ici].

[[Category:Development]]

FAQ Get, update GIT Projekt Quellen

2022-09-24T10:05:06Z

Speaking services: /* Commit und Veröffentlichen von Änderungen */

[[en:FAQ_Get,update_GIT_project_sources]]
[[fr:FAQ_Récupérer,_mettre_à_jour_les_sources_GIT_du_projet]]
[[es:FAQ_Recuperar,_actualizar_GIT_fuentes_del_proyecto]]


[[Category:FAQ DE]]
Hier finden Sie Informationen darüber, wie Sie die Quellen des Dolibarr-Projekts erhalten können.
Es werden mehrere Methoden beschrieben, aber wir empfehlen, die auf GitHub basierende Methode zu verwenden.

 

=Letzte Version der Quellen durch tgz-Download abrufen=
Diese Methode kann auch von nicht-technischen Benutzern verwendet werden.
Sie ermöglicht es Ihnen, die Quellen des Hauptentwicklungszweigs (HEAD genannt) zu erhalten, indem Sie einfach eine Datei herunterladen: Diese Operation besteht darin, die letzte Version der Dolibarr-Dateien zu erhalten, die jede Nacht in eine tgz-Datei gepackt werden. Die Datei ist über einen Link verfügbar:

{{LinkLastSnapshot}}

Neue Dateien überschreiben alte Dateien. Der Nachteil dieser Methode ist, dass Sie das Paket jedes Mal herunterladen und dekomprimieren müssen, wenn Sie Updates erhalten möchten.

Entwickler sollten diese Methode nicht verwenden, um Quellen zu erhalten, sondern die nächste.

=Letzte Version der Quellen über einen anonymen GIT-Zugang abrufen=
Sie können diese Methode verwenden, wenn Sie keinen GIT-Zugang haben. Mit dieser Methode können Sie keine Änderungen einreichen. Wenn Sie also ein Entwickler sind, sollten Sie ein GitHub-Konto erstellen und die nächste Methode anstelle dieser Methode verwenden.

==Voraussetzungen==

*Mit Eclipse IDE

Zuerst müssen Sie eine funktionierende Installation von Eclipse haben. Das '''EGit'''-Plugin muss ebenfalls installiert worden sein.
Verwenden Sie dazu den '''Find And Install process''' im Eclipse Menü, fügen Sie die GIT update URL hinzu:
https://download.eclipse.org/egit/updates
Wählen Sie dann '''EGit''' zur Installation aus (JGit muss nicht ausgewählt werden)

*Mit der GIT-Kommandozeilen-Client-Schnittstelle

Sie müssen den GIT-Client installieren (das GIT-Befehlszeilentool wird unter Linux mit "sudo apt-get install git" installiert, für Windows ist der GIT-Client unter https://git-scm.com/download/win zu finden).

==Clone Prozess==
Geben Sie zunächst den Wert des Repositorys mit den Referenzquellen in Ihr GIT-Client-Tool ein.

*Mit Eclipse, gehen Sie in die Perspektive GIT, klicken Sie auf den Button "GIT Repository klonen". Geben Sie die GIT-URL des Projekts ein, das Sie erhalten möchten.
<source lang="ini">
git://github.com/Dolibarr/dolibarr.git (read only)
oder wenn Sie einen Fork von dolibarr github von der github-Weboberfläche erstellt haben
git@github.com:yourgitaccount/dolibarr.git (read and write access)
</source>
Ihr Eclipse-GIT-Client wird Sie auffordern, die Branches auszuwählen, an denen Sie interessiert sind. Branches, die jetzt noch nicht ausgewählt sind, können später durch einen "Fetch" aus der "Remotes"-Ansicht ausgewählt werden, aber versuchen Sie, nur den Branch auszuwählen, den Sie benötigen. Dies erspart Ihnen später Zeit und Probleme.

Hinweis: Wenn Sie sich hinter einer Firewall befinden, müssen Sie die Eclipse-Proxy-Zugangsdaten im Eclipse-Menü Fenster - Einstellungen - Allgemein - Netzwerkverbindung einstellen und die alternative URL verwenden:
<source lang="ini">
https://gitlogin:gitpassword@github.com/yourgitaccount/dolibarr.git
</source>

*Mit GIT auf der Befehlszeilenschnittstelle:

Richten Sie zunächst Ihren Git-Client ein:
<source lang="bash">
git config --global user.name "Your Name"
git config --global user.email "user@domain.com"
git config --list
</source>
Dann klonen Sie das Repository lokal:
<source lang="bash">
git://github.com/Dolibarr/dolibarr.git (nur lesen)
oder wenn Sie einen Fork von dolibarr github von der github-Weboberfläche erstellt haben
git@github.com:yourgitaccount/dolibarr.git (Lese- und Schreibzugriff)
</source>

Hinweis: Wenn Sie sich hinter einer Firewall befinden, müssen Sie Ihre Proxy-Informationen einstellen und die alternative https-URL verwenden:
<source lang="bash">
git config --global http.proxy http://proxyuser:proxypass@proxyserver:proxyport
git clone https://gitlogin:gitpassword@github.com/yourgitaccount/dolibarr.git dolibarr
</source>

Sobald dieser Schritt bestätigt ist, lädt Ihr GIT-Client alle Dateien vom entfernten GIT-Server herunter. Dies kann einige Sekunden oder Minuten dauern.

Sobald der Download abgeschlossen ist, müssen Sie wählen, an welchem Zweig Sie arbeiten möchten.

*Mit GIT auf der Befehlszeilenschnittstelle;

<source lang="bash">
git checkout develop
git checkout x.y
</source>
Dadurch wird eine lokale Branche erstellt und automatisch ein Checkout durchgeführt.

*Klicken Sie in Eclipse mit der rechten Maustaste auf "Branches - Remotes -" die Branche, die Sie lokal duplizieren möchten".
Wählen Sie " Erstelle Branch" (und markieren Sie das Kästchen "Checkout"). Dadurch wird der Inhalt der Branche dupliziert, um lokal daran zu arbeiten, und Ihr "Arbeitsverzeichnis" wird aktualisiert, um an dieser Branche zu arbeiten.

Erstellen Sie ein Eclipse-Projekt:

Wenn Sie Eclipse verwenden, erstellen Sie, sobald die Verzweigung lokal erstellt wurde, ein PHP-Projekt aus dem Assistenten, indem Sie "'''Create from existing project'''" wählen und das Verzeichnis auswählen, das Ihr lokales GIT-Repository ist (Wählen Sie nicht die Option, ein PHP-Projekt komplett neu zu erstellen).

Klicken Sie dann mit der rechten Maustaste auf das Projekt in Ihrem Eclipse-Arbeitsbereich und wählen Sie "'''Team - Share'''". Wählen Sie GIT und klicken Sie auf die Option "'''Use or create repository in parent folder of project'''".
Eine alternative Methode ist File->Import, Git->Project von Git, Wählen Sie das Git-Repository und Weiter, Assistent für neue Projekte verwenden -> Php-Projekt, geben Sie den Ordner Ihres lokalen GIT-Repositorys ein.

Dann können Sie Eclipse so einstellen, dass es nicht alle Projektdateien für seine Build-Tools (Outline Scanner, TODO Scanner, Syntax Scanner...) scannt. Dies verhindert, dass Eclipse zu langsam ist. Klicken Sie dazu mit der rechten Maustaste auf das Projekt, wählen Sie Build Path und stellen Sie es wie im folgenden Screenshot ein.

[[File:Eclipse php build path.png|240px]]

=Abrufen der letzten Version der Quellen über einen GitHub-Nutzerzugang=
==Voraussetzung==

*Mit Eclipse IDE

Sie müssen zuvor ein Konto auf GitHub (https://github.com/) erstellen und ein öffentliches RSA- oder DSA-Zertifikat in Ihr Kontoprofil hochladen.

Dann müssen Sie eine funktionierende Installation von Eclipse haben. Das '''EGit'''-Plugin muss ebenfalls installiert worden sein.
https://download.eclipse.org/egit/updates
Wählen Sie dann die Installation von '''EGit'''.
*Mit der GIT-Kommandozeilen-Schnittstelle:

Sie müssen zuvor ein Konto auf GitHub (https://github.com/) erstellen und ein öffentliches RSA- oder DSA-Zertifikat in Ihr Kontoprofil hochladen.

Dann müssen Sie den GIT-Client installieren (GIT-Kommandozeilen-Tool unter Linux mit "sudo apt-get install git" oder den GIT-Client für Windows unter https://git-scm.com/download/win).

==Fork Prozess==
Melden Sie sich bei Github mit den Login-Daten an, das Sie im vorherigen Schritt erstellt haben. Gehen Sie dann auf die Seite

https://github.com/Dolibarr/dolibarr

und klicken Sie auf die Schaltfläche "Fork".

Dadurch wird eine Kopie (ein Fork) des Projekts in Ihrem eigenen Github-Bereich erstellt. Da Sie der Besitzer dieses Forks sind, haben Sie alle Rechte, die Sie für die nächsten Schritte benötigen.

==Clone Prozess==
Dann ist der Prozess derselbe wie bei der Beschaffung von Quellen mit anonymen Zugriff.

Die für den GIT-Clone zu verwendende URL ist dieselbe:
<source lang="ini">
git@github.com:YourGitHubLogin/dolibarr.git
</source>

Beachten Sie, dass es auch eine HTTPS-URL gibt, die aber manchmal offline ist (verwenden Sie also lieber die erste, ein Link mit HTTPS ist nur erforderlich, wenn Sie sich hinter einer Firewall befinden):

<source lang="ini">
https://yourgithublogin@github.com/Dolibarr/dolibarr.git
</source>

=Update des Repository=
So aktualisieren Sie Ihren lokalen Workspace:

*Mit Eclipse IDE:

Rechtsklick auf das Eclipse-Projekt und Auswahl von "Pull".

Wenn Sie in Ihrem Eclipse-Workspace Änderungen an Dateien vorgenommen haben, die in der GIT-Remote-Referenz geändert wurden, wird Ihr GIT-Client automatisch einen Merge durchführen.

*Wenn es Konflikte gibt, wird der Merge alle Konfliktdateien als "Konflikt" markieren (siehe später, um diesen Zustand zu lösen).
*Wenn nicht, erhalten Sie alle Dateien in der neuen Version, einschließlich aller Ihrer Änderungen.

Wenn Sie bereits einige Dateien in Ihr lokales Repository übertragen haben, wird Ihr Workspace als "Zusammengeführt" markiert.
Alles was Sie tun müssen, ist ein Commit zu machen, um Ihr lokales Repository zu bestätigen, dass es sowohl Ihre Änderungen als auch die Änderungen anderer enthält.

*Mit dem GIT Command Line Client Interface:

<source lang="bash">
git pull
</source>

=Commit und Veröffentlichen von Änderungen=
Um alle Änderungen zu sehen, die Sie in Ihrem Arbeitsverzeichnis vorgenommen haben und die darauf warten, in Git hinzugefügt zu werden:

*Mit GIT Command Line Interface:

<source lang="bash">
git status
git diff subdir/filename
</source>

Um Änderungen, die Sie in Ihrem lokalen Repository vorgenommen haben, in den GIT-Index aufzunehmen, führen Sie einen commit-Befehl für diesen Index durch:

*Mit Eclipse: Klicken Sie mit der rechten Maustaste auf die zu übertragende Datei oder das Verzeichnis. Wählen Sie die Datei zum Hinzufügen/Entfernen/Aktualisieren in den nächsten Commit.
*Mit GIT Command Line Interface:

<source lang="bash">
git commit -a -m "Commit text"
</source>
Dadurch werden Hinzufügungen und Änderungen in Ihrem lokalen Branch gespeichert.

Um sie auf den GIT-Repository-Server zu pushen,

*With Eclipse: Klicken Sie mit der rechten Maustaste auf das Projekt und wählen Sie "'''Team - Push to Upstream'''".
*With GIT Command Line Interface:

<source lang="bash">
git push
</source>

Um ein Commit abzubrechen:

*Mit GIT Command Line Interface, wenn der Commit noch nicht gepusht wurde:

<source lang="bash">
git reset --soft HEAD~1
</source>

*Mit GIT Command Line Interface, wenn ein Commit bereits gepusht wurde:

<source lang="bash">
git revert IdCommit or git revert HEAD (for last commit)
</source>

Um Änderungen, die in Ihrer GIT-Instanz vorgenommen wurden, in die offizielle Dolibarr-Instanz einzubinden:

*Gehen Sie in die GitHub-Weboberfläche Ihrer geforkten Git-Instanz.
*Klicken Sie auf die kleine Schaltfläche "Create a Pull request".
*Wählen Sie den Commit aus, dessen Aufnahme Sie beantragen, und validieren Sie ihn.

=Ask official project to include your changes=
Once you pushed one or several commit toward your distant fork area on github, you can ask the Dolibarr core team to include it into official project.
For this, follow this tutorial: https://help.github.com/articles/creating-a-pull-request/

=Add an external commit into current repository=
Some developers may work and do commit into their own Git repository after forking the project. If you are interesting into getting this changes, you can import them with the following steps.

You need both Eclipse and GIT Command Line interface to achieve this:

*First, go into GIT setup view and right click on "'''Remotes'''" of your Eclipse Git working space and choose "'''Create a remote...'''"
*Type name or remote fork the developer has create (in most cases, it's developer Git login). For example: "'''thedevlogin'''". Choose also "'''Configure Fetch'''".
*Type URI of Git repository of developer. For example: '''git://github.com/thedevlogin/dolibarr.git'''. Also add a refspec value to declare the branch you want to get. For example: '''refs/heads/master:refs/remotes/thedevlogin/master'''. Click "'''Save and Fetch'''". A new entry will be added into "Remote Tracking" making possible to read/get commits done into this branch.
Gehen Sie nun in die Kommandozeile Ihres Git-Repositorys (unter Linux ist es in den meisten Fällen '''/home/yourlogin/git/yourdolibarr''') und geben Sie den Befehl git cherry-pick ein:
<source lang="bash">
git cherry-pick -x commitid
</source>
wobei commitid der Wert der Commit-ID ist, die Sie erhalten möchten.

Sobald dies erledigt ist, gehen Sie zurück zu Eclipse und aktualisieren Sie das Projekt. Sie werden sehen, dass geänderte Dateien mit Dekoratoren erscheinen (mit Konflikten, wenn es welche gibt).

Wenn die Auswahl aufgrund von Konflikten fehlschlägt, können Sie den Versuch der Auswahl mit
<source lang="bash">
git cherry-pick --abort
</source>

=Einen Konflikt lösen=
Wenn eine Datei nach einem "Pull" als "Konflikt" markiert ist, öffnen Sie die Datei und bearbeiten Sie sie.
Rechercher la chaine "<<<<<<<<<<", vous verrez la partie de code en conflit entre "<<<<<<<<<" et ">>>>>>>>". Bearbeiten Sie die Codezeilen manuell, um das Endergebnis zu erhalten, indem Sie auch die "<<<<<<<<" et ">>>>>>>".

Klicken Sie dann mit der rechten Maustaste auf die Datei und wählen Sie " Hinzufügen".

Wenn Sie lieber alle Änderungen, die Sie an allen Dateien vorgenommen haben, vollständig rückgängig machen möchten (um Ihren Arbeitsbereich mit dem Inhalt des entfernten Repositoriums wiederherzustellen), können Sie einen Reset durchführen:

*Mit Eclipse klicken Sie mit der rechten Maustaste auf die oberste Zeile des Projekts und wählen Sie "Zurücksetzen" und dann "'''Hard'''" und dann "'''Reference - HEAD'''".
*Bei Verwendung des GIT-Befehlszeilentools erreichen Sie dies mit dem Befehl

<source lang="bash">
git reset --hard HEAD
</source>

=Taggen Sie die Quellen=
Mit den GIT-Kommandozeilenwerkzeugen:
Um ein Tag über eine Version zu erstellen:
<source lang="bash">
git tag -a -m "Release|Maintenance release x.y.z" "x.y.z"
oder
git tag -a -f -m "Beta x.y.betai" "x.y.betai_YYYYMMDD" idcommit # -f force wenn ein Tag bereits existiert, ermöglicht idcommit die Auswahl des zu taggenden Commits.
git push --tags # Pour pousser le tags sur le serveur distant
</source>

Um einen Tag zu löschen:
<source lang="bash">
git tag -d "x.y.z_YYYYMMDD"
git push origin :x.y.z_YYYYMMDD # Um die Löschung auf dem entfernten Server zu bestätigen
</source>

=Einen neue Branche erstellen=
Hier ist der Befehl, den Sie verwenden müssen, um einen neuen Zweig aus einem eigenen develop-Repository zu erstellen:
<source lang="bash">
git branch x.y
git push origin x.y
</source>

=Statistiken=
Mit den GIT-Kommandozeilenwerkzeugen:

Um die Anzahl der Änderungen zu zählen, die ein Entwickler zwischen Version x und y vorgenommen hat:

*Zuerst führen Sie "git merge-base" aus, um die ID des letzten gemeinsamen Commits zwischen x und y zu erfahren.

<source lang="bash">
git merge-base origin/3.1 origin/develop
</source>

*Dann führen Sie git log aus, um eine Liste aller Änderungen von der letzten gemeinsamen Übertragung bis zur letzten Übertragung zu erhalten.
<source lang="bash">
git log id_found_at_previous_step..HEAD
</source>

*Um die Gesamtzahl der hinzugefügten/gelöschten Zeilen zu ermitteln:
<source lang="bash">
git log --ancestry-path --numstat --pretty="%H" id_found_at_previous_step..HEAD | awk 'NF==3 {plus+=$1; minus+=$2} END {printf("+%d, -%d\n", plus, minus)}'
</source>

Zählen der endgültigen Änderungen zwischen einer Version x und y (dies unterscheidet sich von der vorherigen Zählung, da bei der vorherigen Zählung eine Änderung zweimal zu zwei verschiedenen Zeitpunkten durchgeführt werden kann, um unterschiedliche Änderungen vorzunehmen. Bei der zweiten Methode werden die Änderungen gezählt, die schließlich gefunden wurden, wenn die Änderungen beim ersten Versuch in Ordnung waren):

*Verwenden Sie die gleiche Methode wie zuvor, aber anstatt git log auszuführen, führen Sie '''git diff''' aus.

<source lang="bash">
git diff -b -M --numstat --pretty="%H" id_found_at_previous_step..HEAD | awk 'NF==3 {plus+=$1; minus+=$2} END {printf("+%d, -%d\n", plus, minus)}'
</source>

Weitere Informationen über die Verwendung von GIT erhältlich unter: [http://wiki.eclipse.org/EGit/User_Guide ici].

[[Category:Development]]

FAQ Get, update GIT Projekt Quellen

2022-09-24T10:01:40Z

Speaking services: /* Commit und Veröffentlichen von Änderungen */

[[en:FAQ_Get,update_GIT_project_sources]]
[[fr:FAQ_Récupérer,_mettre_à_jour_les_sources_GIT_du_projet]]
[[es:FAQ_Recuperar,_actualizar_GIT_fuentes_del_proyecto]]


[[Category:FAQ DE]]
Hier finden Sie Informationen darüber, wie Sie die Quellen des Dolibarr-Projekts erhalten können.
Es werden mehrere Methoden beschrieben, aber wir empfehlen, die auf GitHub basierende Methode zu verwenden.

 

=Letzte Version der Quellen durch tgz-Download abrufen=
Diese Methode kann auch von nicht-technischen Benutzern verwendet werden.
Sie ermöglicht es Ihnen, die Quellen des Hauptentwicklungszweigs (HEAD genannt) zu erhalten, indem Sie einfach eine Datei herunterladen: Diese Operation besteht darin, die letzte Version der Dolibarr-Dateien zu erhalten, die jede Nacht in eine tgz-Datei gepackt werden. Die Datei ist über einen Link verfügbar:

{{LinkLastSnapshot}}

Neue Dateien überschreiben alte Dateien. Der Nachteil dieser Methode ist, dass Sie das Paket jedes Mal herunterladen und dekomprimieren müssen, wenn Sie Updates erhalten möchten.

Entwickler sollten diese Methode nicht verwenden, um Quellen zu erhalten, sondern die nächste.

=Letzte Version der Quellen über einen anonymen GIT-Zugang abrufen=
Sie können diese Methode verwenden, wenn Sie keinen GIT-Zugang haben. Mit dieser Methode können Sie keine Änderungen einreichen. Wenn Sie also ein Entwickler sind, sollten Sie ein GitHub-Konto erstellen und die nächste Methode anstelle dieser Methode verwenden.

==Voraussetzungen==

*Mit Eclipse IDE

Zuerst müssen Sie eine funktionierende Installation von Eclipse haben. Das '''EGit'''-Plugin muss ebenfalls installiert worden sein.
Verwenden Sie dazu den '''Find And Install process''' im Eclipse Menü, fügen Sie die GIT update URL hinzu:
https://download.eclipse.org/egit/updates
Wählen Sie dann '''EGit''' zur Installation aus (JGit muss nicht ausgewählt werden)

*Mit der GIT-Kommandozeilen-Client-Schnittstelle

Sie müssen den GIT-Client installieren (das GIT-Befehlszeilentool wird unter Linux mit "sudo apt-get install git" installiert, für Windows ist der GIT-Client unter https://git-scm.com/download/win zu finden).

==Clone Prozess==
Geben Sie zunächst den Wert des Repositorys mit den Referenzquellen in Ihr GIT-Client-Tool ein.

*Mit Eclipse, gehen Sie in die Perspektive GIT, klicken Sie auf den Button "GIT Repository klonen". Geben Sie die GIT-URL des Projekts ein, das Sie erhalten möchten.
<source lang="ini">
git://github.com/Dolibarr/dolibarr.git (read only)
oder wenn Sie einen Fork von dolibarr github von der github-Weboberfläche erstellt haben
git@github.com:yourgitaccount/dolibarr.git (read and write access)
</source>
Ihr Eclipse-GIT-Client wird Sie auffordern, die Branches auszuwählen, an denen Sie interessiert sind. Branches, die jetzt noch nicht ausgewählt sind, können später durch einen "Fetch" aus der "Remotes"-Ansicht ausgewählt werden, aber versuchen Sie, nur den Branch auszuwählen, den Sie benötigen. Dies erspart Ihnen später Zeit und Probleme.

Hinweis: Wenn Sie sich hinter einer Firewall befinden, müssen Sie die Eclipse-Proxy-Zugangsdaten im Eclipse-Menü Fenster - Einstellungen - Allgemein - Netzwerkverbindung einstellen und die alternative URL verwenden:
<source lang="ini">
https://gitlogin:gitpassword@github.com/yourgitaccount/dolibarr.git
</source>

*Mit GIT auf der Befehlszeilenschnittstelle:

Richten Sie zunächst Ihren Git-Client ein:
<source lang="bash">
git config --global user.name "Your Name"
git config --global user.email "user@domain.com"
git config --list
</source>
Dann klonen Sie das Repository lokal:
<source lang="bash">
git://github.com/Dolibarr/dolibarr.git (nur lesen)
oder wenn Sie einen Fork von dolibarr github von der github-Weboberfläche erstellt haben
git@github.com:yourgitaccount/dolibarr.git (Lese- und Schreibzugriff)
</source>

Hinweis: Wenn Sie sich hinter einer Firewall befinden, müssen Sie Ihre Proxy-Informationen einstellen und die alternative https-URL verwenden:
<source lang="bash">
git config --global http.proxy http://proxyuser:proxypass@proxyserver:proxyport
git clone https://gitlogin:gitpassword@github.com/yourgitaccount/dolibarr.git dolibarr
</source>

Sobald dieser Schritt bestätigt ist, lädt Ihr GIT-Client alle Dateien vom entfernten GIT-Server herunter. Dies kann einige Sekunden oder Minuten dauern.

Sobald der Download abgeschlossen ist, müssen Sie wählen, an welchem Zweig Sie arbeiten möchten.

*Mit GIT auf der Befehlszeilenschnittstelle;

<source lang="bash">
git checkout develop
git checkout x.y
</source>
Dadurch wird eine lokale Branche erstellt und automatisch ein Checkout durchgeführt.

*Klicken Sie in Eclipse mit der rechten Maustaste auf "Branches - Remotes -" die Branche, die Sie lokal duplizieren möchten".
Wählen Sie " Erstelle Branch" (und markieren Sie das Kästchen "Checkout"). Dadurch wird der Inhalt der Branche dupliziert, um lokal daran zu arbeiten, und Ihr "Arbeitsverzeichnis" wird aktualisiert, um an dieser Branche zu arbeiten.

Erstellen Sie ein Eclipse-Projekt:

Wenn Sie Eclipse verwenden, erstellen Sie, sobald die Verzweigung lokal erstellt wurde, ein PHP-Projekt aus dem Assistenten, indem Sie "'''Create from existing project'''" wählen und das Verzeichnis auswählen, das Ihr lokales GIT-Repository ist (Wählen Sie nicht die Option, ein PHP-Projekt komplett neu zu erstellen).

Klicken Sie dann mit der rechten Maustaste auf das Projekt in Ihrem Eclipse-Arbeitsbereich und wählen Sie "'''Team - Share'''". Wählen Sie GIT und klicken Sie auf die Option "'''Use or create repository in parent folder of project'''".
Eine alternative Methode ist File->Import, Git->Project von Git, Wählen Sie das Git-Repository und Weiter, Assistent für neue Projekte verwenden -> Php-Projekt, geben Sie den Ordner Ihres lokalen GIT-Repositorys ein.

Dann können Sie Eclipse so einstellen, dass es nicht alle Projektdateien für seine Build-Tools (Outline Scanner, TODO Scanner, Syntax Scanner...) scannt. Dies verhindert, dass Eclipse zu langsam ist. Klicken Sie dazu mit der rechten Maustaste auf das Projekt, wählen Sie Build Path und stellen Sie es wie im folgenden Screenshot ein.

[[File:Eclipse php build path.png|240px]]

=Abrufen der letzten Version der Quellen über einen GitHub-Nutzerzugang=
==Voraussetzung==

*Mit Eclipse IDE

Sie müssen zuvor ein Konto auf GitHub (https://github.com/) erstellen und ein öffentliches RSA- oder DSA-Zertifikat in Ihr Kontoprofil hochladen.

Dann müssen Sie eine funktionierende Installation von Eclipse haben. Das '''EGit'''-Plugin muss ebenfalls installiert worden sein.
https://download.eclipse.org/egit/updates
Wählen Sie dann die Installation von '''EGit'''.
*Mit der GIT-Kommandozeilen-Schnittstelle:

Sie müssen zuvor ein Konto auf GitHub (https://github.com/) erstellen und ein öffentliches RSA- oder DSA-Zertifikat in Ihr Kontoprofil hochladen.

Dann müssen Sie den GIT-Client installieren (GIT-Kommandozeilen-Tool unter Linux mit "sudo apt-get install git" oder den GIT-Client für Windows unter https://git-scm.com/download/win).

==Fork Prozess==
Melden Sie sich bei Github mit den Login-Daten an, das Sie im vorherigen Schritt erstellt haben. Gehen Sie dann auf die Seite

https://github.com/Dolibarr/dolibarr

und klicken Sie auf die Schaltfläche "Fork".

Dadurch wird eine Kopie (ein Fork) des Projekts in Ihrem eigenen Github-Bereich erstellt. Da Sie der Besitzer dieses Forks sind, haben Sie alle Rechte, die Sie für die nächsten Schritte benötigen.

==Clone Prozess==
Dann ist der Prozess derselbe wie bei der Beschaffung von Quellen mit anonymen Zugriff.

Die für den GIT-Clone zu verwendende URL ist dieselbe:
<source lang="ini">
git@github.com:YourGitHubLogin/dolibarr.git
</source>

Beachten Sie, dass es auch eine HTTPS-URL gibt, die aber manchmal offline ist (verwenden Sie also lieber die erste, ein Link mit HTTPS ist nur erforderlich, wenn Sie sich hinter einer Firewall befinden):

<source lang="ini">
https://yourgithublogin@github.com/Dolibarr/dolibarr.git
</source>

=Update des Repository=
So aktualisieren Sie Ihren lokalen Workspace:

*Mit Eclipse IDE:

Rechtsklick auf das Eclipse-Projekt und Auswahl von "Pull".

Wenn Sie in Ihrem Eclipse-Workspace Änderungen an Dateien vorgenommen haben, die in der GIT-Remote-Referenz geändert wurden, wird Ihr GIT-Client automatisch einen Merge durchführen.

*Wenn es Konflikte gibt, wird der Merge alle Konfliktdateien als "Konflikt" markieren (siehe später, um diesen Zustand zu lösen).
*Wenn nicht, erhalten Sie alle Dateien in der neuen Version, einschließlich aller Ihrer Änderungen.

Wenn Sie bereits einige Dateien in Ihr lokales Repository übertragen haben, wird Ihr Workspace als "Zusammengeführt" markiert.
Alles was Sie tun müssen, ist ein Commit zu machen, um Ihr lokales Repository zu bestätigen, dass es sowohl Ihre Änderungen als auch die Änderungen anderer enthält.

*Mit dem GIT Command Line Client Interface:

<source lang="bash">
git pull
</source>

=Commit und Veröffentlichen von Änderungen=
Um alle Änderungen zu sehen, die Sie in Ihrem Arbeitsverzeichnis vorgenommen haben und die darauf warten, in Git hinzugefügt zu werden:

*Mit GIT Command Line Interface:

<source lang="bash">
git status
git diff subdir/filename
</source>

Um Änderungen, die Sie in Ihrem lokalen Repository vorgenommen haben, in den GIT-Index aufzunehmen, führen Sie einen commit-Befehl für diesen Index durch:

*Mit Eclipse: Klicken Sie mit der rechten Maustaste auf die zu übertragende Datei oder das Verzeichnis. Wählen Sie die Datei zum Hinzufügen/Entfernen/Aktualisieren in den nächsten Commit.
*Mit GIT Command Line Interface:

<source lang="bash">
git commit -a -m "Commit text"
</source>
Dadurch werden Hinzufügungen und Änderungen in Ihrem lokalen Branch gespeichert.

Um sie auf den GIT-Repository-Server zu pushen,

*With Eclipse: Klicken Sie mit der rechten Maustaste auf das Projekt und wählen Sie "'''Team - Push to Upstream'''".
*With GIT Command Line Interface:

<source lang="bash">
git push
</source>

Um ein Commit abzubrechen:

*Mit GIT Command Line Interface, wenn der Commit noch nicht gepusht wurde:

<source lang="bash">
git reset --soft HEAD~1
</source>

*Mit GIT Command Line Interface, wenn ein Commit bereits gepusht wurde:

<source lang="bash">
git revert IdCommit or git revert HEAD (for last commit)
</source>

Um Änderungen, die in Ihrer GIT-Instanz vorgenommen wurden, in die offizielle Dolibarr-Instanz einzubinden:

*Go into GitHub web interface of your forked Git instance.
*Click on small button "Create a Pull request".
*Choose commit you request inclusion and validate.

=Ask official project to include your changes=
Once you pushed one or several commit toward your distant fork area on github, you can ask the Dolibarr core team to include it into official project.
For this, follow this tutorial: https://help.github.com/articles/creating-a-pull-request/

=Add an external commit into current repository=
Some developers may work and do commit into their own Git repository after forking the project. If you are interesting into getting this changes, you can import them with the following steps.

You need both Eclipse and GIT Command Line interface to achieve this:

*First, go into GIT setup view and right click on "'''Remotes'''" of your Eclipse Git working space and choose "'''Create a remote...'''"
*Type name or remote fork the developer has create (in most cases, it's developer Git login). For example: "'''thedevlogin'''". Choose also "'''Configure Fetch'''".
*Type URI of Git repository of developer. For example: '''git://github.com/thedevlogin/dolibarr.git'''. Also add a refspec value to declare the branch you want to get. For example: '''refs/heads/master:refs/remotes/thedevlogin/master'''. Click "'''Save and Fetch'''". A new entry will be added into "Remote Tracking" making possible to read/get commits done into this branch.
Gehen Sie nun in die Kommandozeile Ihres Git-Repositorys (unter Linux ist es in den meisten Fällen '''/home/yourlogin/git/yourdolibarr''') und geben Sie den Befehl git cherry-pick ein:
<source lang="bash">
git cherry-pick -x commitid
</source>
wobei commitid der Wert der Commit-ID ist, die Sie erhalten möchten.

Sobald dies erledigt ist, gehen Sie zurück zu Eclipse und aktualisieren Sie das Projekt. Sie werden sehen, dass geänderte Dateien mit Dekoratoren erscheinen (mit Konflikten, wenn es welche gibt).

Wenn die Auswahl aufgrund von Konflikten fehlschlägt, können Sie den Versuch der Auswahl mit
<source lang="bash">
git cherry-pick --abort
</source>

=Einen Konflikt lösen=
Wenn eine Datei nach einem "Pull" als "Konflikt" markiert ist, öffnen Sie die Datei und bearbeiten Sie sie.
Rechercher la chaine "<<<<<<<<<<", vous verrez la partie de code en conflit entre "<<<<<<<<<" et ">>>>>>>>". Bearbeiten Sie die Codezeilen manuell, um das Endergebnis zu erhalten, indem Sie auch die "<<<<<<<<" et ">>>>>>>".

Klicken Sie dann mit der rechten Maustaste auf die Datei und wählen Sie " Hinzufügen".

Wenn Sie lieber alle Änderungen, die Sie an allen Dateien vorgenommen haben, vollständig rückgängig machen möchten (um Ihren Arbeitsbereich mit dem Inhalt des entfernten Repositoriums wiederherzustellen), können Sie einen Reset durchführen:

*Mit Eclipse klicken Sie mit der rechten Maustaste auf die oberste Zeile des Projekts und wählen Sie "Zurücksetzen" und dann "'''Hard'''" und dann "'''Reference - HEAD'''".
*Bei Verwendung des GIT-Befehlszeilentools erreichen Sie dies mit dem Befehl

<source lang="bash">
git reset --hard HEAD
</source>

=Taggen Sie die Quellen=
Mit den GIT-Kommandozeilenwerkzeugen:
Um ein Tag über eine Version zu erstellen:
<source lang="bash">
git tag -a -m "Release|Maintenance release x.y.z" "x.y.z"
oder
git tag -a -f -m "Beta x.y.betai" "x.y.betai_YYYYMMDD" idcommit # -f force wenn ein Tag bereits existiert, ermöglicht idcommit die Auswahl des zu taggenden Commits.
git push --tags # Pour pousser le tags sur le serveur distant
</source>

Um einen Tag zu löschen:
<source lang="bash">
git tag -d "x.y.z_YYYYMMDD"
git push origin :x.y.z_YYYYMMDD # Um die Löschung auf dem entfernten Server zu bestätigen
</source>

=Einen neue Branche erstellen=
Hier ist der Befehl, den Sie verwenden müssen, um einen neuen Zweig aus einem eigenen develop-Repository zu erstellen:
<source lang="bash">
git branch x.y
git push origin x.y
</source>

=Statistiken=
Mit den GIT-Kommandozeilenwerkzeugen:

Um die Anzahl der Änderungen zu zählen, die ein Entwickler zwischen Version x und y vorgenommen hat:

*Zuerst führen Sie "git merge-base" aus, um die ID des letzten gemeinsamen Commits zwischen x und y zu erfahren.

<source lang="bash">
git merge-base origin/3.1 origin/develop
</source>

*Dann führen Sie git log aus, um eine Liste aller Änderungen von der letzten gemeinsamen Übertragung bis zur letzten Übertragung zu erhalten.
<source lang="bash">
git log id_found_at_previous_step..HEAD
</source>

*Um die Gesamtzahl der hinzugefügten/gelöschten Zeilen zu ermitteln:
<source lang="bash">
git log --ancestry-path --numstat --pretty="%H" id_found_at_previous_step..HEAD | awk 'NF==3 {plus+=$1; minus+=$2} END {printf("+%d, -%d\n", plus, minus)}'
</source>

Zählen der endgültigen Änderungen zwischen einer Version x und y (dies unterscheidet sich von der vorherigen Zählung, da bei der vorherigen Zählung eine Änderung zweimal zu zwei verschiedenen Zeitpunkten durchgeführt werden kann, um unterschiedliche Änderungen vorzunehmen. Bei der zweiten Methode werden die Änderungen gezählt, die schließlich gefunden wurden, wenn die Änderungen beim ersten Versuch in Ordnung waren):

*Verwenden Sie die gleiche Methode wie zuvor, aber anstatt git log auszuführen, führen Sie '''git diff''' aus.

<source lang="bash">
git diff -b -M --numstat --pretty="%H" id_found_at_previous_step..HEAD | awk 'NF==3 {plus+=$1; minus+=$2} END {printf("+%d, -%d\n", plus, minus)}'
</source>

Weitere Informationen über die Verwendung von GIT erhältlich unter: [http://wiki.eclipse.org/EGit/User_Guide ici].

[[Category:Development]]

FAQ Get, update GIT Projekt Quellen

2022-09-24T09:24:11Z

Speaking services: /* Commit und Veröffentlichen von Änderungen */

[[en:FAQ_Get,update_GIT_project_sources]]
[[fr:FAQ_Récupérer,_mettre_à_jour_les_sources_GIT_du_projet]]
[[es:FAQ_Recuperar,_actualizar_GIT_fuentes_del_proyecto]]


[[Category:FAQ DE]]
Hier finden Sie Informationen darüber, wie Sie die Quellen des Dolibarr-Projekts erhalten können.
Es werden mehrere Methoden beschrieben, aber wir empfehlen, die auf GitHub basierende Methode zu verwenden.

 

=Letzte Version der Quellen durch tgz-Download abrufen=
Diese Methode kann auch von nicht-technischen Benutzern verwendet werden.
Sie ermöglicht es Ihnen, die Quellen des Hauptentwicklungszweigs (HEAD genannt) zu erhalten, indem Sie einfach eine Datei herunterladen: Diese Operation besteht darin, die letzte Version der Dolibarr-Dateien zu erhalten, die jede Nacht in eine tgz-Datei gepackt werden. Die Datei ist über einen Link verfügbar:

{{LinkLastSnapshot}}

Neue Dateien überschreiben alte Dateien. Der Nachteil dieser Methode ist, dass Sie das Paket jedes Mal herunterladen und dekomprimieren müssen, wenn Sie Updates erhalten möchten.

Entwickler sollten diese Methode nicht verwenden, um Quellen zu erhalten, sondern die nächste.

=Letzte Version der Quellen über einen anonymen GIT-Zugang abrufen=
Sie können diese Methode verwenden, wenn Sie keinen GIT-Zugang haben. Mit dieser Methode können Sie keine Änderungen einreichen. Wenn Sie also ein Entwickler sind, sollten Sie ein GitHub-Konto erstellen und die nächste Methode anstelle dieser Methode verwenden.

==Voraussetzungen==

*Mit Eclipse IDE

Zuerst müssen Sie eine funktionierende Installation von Eclipse haben. Das '''EGit'''-Plugin muss ebenfalls installiert worden sein.
Verwenden Sie dazu den '''Find And Install process''' im Eclipse Menü, fügen Sie die GIT update URL hinzu:
https://download.eclipse.org/egit/updates
Wählen Sie dann '''EGit''' zur Installation aus (JGit muss nicht ausgewählt werden)

*Mit der GIT-Kommandozeilen-Client-Schnittstelle

Sie müssen den GIT-Client installieren (das GIT-Befehlszeilentool wird unter Linux mit "sudo apt-get install git" installiert, für Windows ist der GIT-Client unter https://git-scm.com/download/win zu finden).

==Clone Prozess==
Geben Sie zunächst den Wert des Repositorys mit den Referenzquellen in Ihr GIT-Client-Tool ein.

*Mit Eclipse, gehen Sie in die Perspektive GIT, klicken Sie auf den Button "GIT Repository klonen". Geben Sie die GIT-URL des Projekts ein, das Sie erhalten möchten.
<source lang="ini">
git://github.com/Dolibarr/dolibarr.git (read only)
oder wenn Sie einen Fork von dolibarr github von der github-Weboberfläche erstellt haben
git@github.com:yourgitaccount/dolibarr.git (read and write access)
</source>
Ihr Eclipse-GIT-Client wird Sie auffordern, die Branches auszuwählen, an denen Sie interessiert sind. Branches, die jetzt noch nicht ausgewählt sind, können später durch einen "Fetch" aus der "Remotes"-Ansicht ausgewählt werden, aber versuchen Sie, nur den Branch auszuwählen, den Sie benötigen. Dies erspart Ihnen später Zeit und Probleme.

Hinweis: Wenn Sie sich hinter einer Firewall befinden, müssen Sie die Eclipse-Proxy-Zugangsdaten im Eclipse-Menü Fenster - Einstellungen - Allgemein - Netzwerkverbindung einstellen und die alternative URL verwenden:
<source lang="ini">
https://gitlogin:gitpassword@github.com/yourgitaccount/dolibarr.git
</source>

*Mit GIT auf der Befehlszeilenschnittstelle:

Richten Sie zunächst Ihren Git-Client ein:
<source lang="bash">
git config --global user.name "Your Name"
git config --global user.email "user@domain.com"
git config --list
</source>
Dann klonen Sie das Repository lokal:
<source lang="bash">
git://github.com/Dolibarr/dolibarr.git (nur lesen)
oder wenn Sie einen Fork von dolibarr github von der github-Weboberfläche erstellt haben
git@github.com:yourgitaccount/dolibarr.git (Lese- und Schreibzugriff)
</source>

Hinweis: Wenn Sie sich hinter einer Firewall befinden, müssen Sie Ihre Proxy-Informationen einstellen und die alternative https-URL verwenden:
<source lang="bash">
git config --global http.proxy http://proxyuser:proxypass@proxyserver:proxyport
git clone https://gitlogin:gitpassword@github.com/yourgitaccount/dolibarr.git dolibarr
</source>

Sobald dieser Schritt bestätigt ist, lädt Ihr GIT-Client alle Dateien vom entfernten GIT-Server herunter. Dies kann einige Sekunden oder Minuten dauern.

Sobald der Download abgeschlossen ist, müssen Sie wählen, an welchem Zweig Sie arbeiten möchten.

*Mit GIT auf der Befehlszeilenschnittstelle;

<source lang="bash">
git checkout develop
git checkout x.y
</source>
Dadurch wird eine lokale Branche erstellt und automatisch ein Checkout durchgeführt.

*Klicken Sie in Eclipse mit der rechten Maustaste auf "Branches - Remotes -" die Branche, die Sie lokal duplizieren möchten".
Wählen Sie " Erstelle Branch" (und markieren Sie das Kästchen "Checkout"). Dadurch wird der Inhalt der Branche dupliziert, um lokal daran zu arbeiten, und Ihr "Arbeitsverzeichnis" wird aktualisiert, um an dieser Branche zu arbeiten.

Erstellen Sie ein Eclipse-Projekt:

Wenn Sie Eclipse verwenden, erstellen Sie, sobald die Verzweigung lokal erstellt wurde, ein PHP-Projekt aus dem Assistenten, indem Sie "'''Create from existing project'''" wählen und das Verzeichnis auswählen, das Ihr lokales GIT-Repository ist (Wählen Sie nicht die Option, ein PHP-Projekt komplett neu zu erstellen).

Klicken Sie dann mit der rechten Maustaste auf das Projekt in Ihrem Eclipse-Arbeitsbereich und wählen Sie "'''Team - Share'''". Wählen Sie GIT und klicken Sie auf die Option "'''Use or create repository in parent folder of project'''".
Eine alternative Methode ist File->Import, Git->Project von Git, Wählen Sie das Git-Repository und Weiter, Assistent für neue Projekte verwenden -> Php-Projekt, geben Sie den Ordner Ihres lokalen GIT-Repositorys ein.

Dann können Sie Eclipse so einstellen, dass es nicht alle Projektdateien für seine Build-Tools (Outline Scanner, TODO Scanner, Syntax Scanner...) scannt. Dies verhindert, dass Eclipse zu langsam ist. Klicken Sie dazu mit der rechten Maustaste auf das Projekt, wählen Sie Build Path und stellen Sie es wie im folgenden Screenshot ein.

[[File:Eclipse php build path.png|240px]]

=Abrufen der letzten Version der Quellen über einen GitHub-Nutzerzugang=
==Voraussetzung==

*Mit Eclipse IDE

Sie müssen zuvor ein Konto auf GitHub (https://github.com/) erstellen und ein öffentliches RSA- oder DSA-Zertifikat in Ihr Kontoprofil hochladen.

Dann müssen Sie eine funktionierende Installation von Eclipse haben. Das '''EGit'''-Plugin muss ebenfalls installiert worden sein.
https://download.eclipse.org/egit/updates
Wählen Sie dann die Installation von '''EGit'''.
*Mit der GIT-Kommandozeilen-Schnittstelle:

Sie müssen zuvor ein Konto auf GitHub (https://github.com/) erstellen und ein öffentliches RSA- oder DSA-Zertifikat in Ihr Kontoprofil hochladen.

Dann müssen Sie den GIT-Client installieren (GIT-Kommandozeilen-Tool unter Linux mit "sudo apt-get install git" oder den GIT-Client für Windows unter https://git-scm.com/download/win).

==Fork Prozess==
Melden Sie sich bei Github mit den Login-Daten an, das Sie im vorherigen Schritt erstellt haben. Gehen Sie dann auf die Seite

https://github.com/Dolibarr/dolibarr

und klicken Sie auf die Schaltfläche "Fork".

Dadurch wird eine Kopie (ein Fork) des Projekts in Ihrem eigenen Github-Bereich erstellt. Da Sie der Besitzer dieses Forks sind, haben Sie alle Rechte, die Sie für die nächsten Schritte benötigen.

==Clone Prozess==
Dann ist der Prozess derselbe wie bei der Beschaffung von Quellen mit anonymen Zugriff.

Die für den GIT-Clone zu verwendende URL ist dieselbe:
<source lang="ini">
git@github.com:YourGitHubLogin/dolibarr.git
</source>

Beachten Sie, dass es auch eine HTTPS-URL gibt, die aber manchmal offline ist (verwenden Sie also lieber die erste, ein Link mit HTTPS ist nur erforderlich, wenn Sie sich hinter einer Firewall befinden):

<source lang="ini">
https://yourgithublogin@github.com/Dolibarr/dolibarr.git
</source>

=Update des Repository=
So aktualisieren Sie Ihren lokalen Workspace:

*Mit Eclipse IDE:

Rechtsklick auf das Eclipse-Projekt und Auswahl von "Pull".

Wenn Sie in Ihrem Eclipse-Workspace Änderungen an Dateien vorgenommen haben, die in der GIT-Remote-Referenz geändert wurden, wird Ihr GIT-Client automatisch einen Merge durchführen.

*Wenn es Konflikte gibt, wird der Merge alle Konfliktdateien als "Konflikt" markieren (siehe später, um diesen Zustand zu lösen).
*Wenn nicht, erhalten Sie alle Dateien in der neuen Version, einschließlich aller Ihrer Änderungen.

Wenn Sie bereits einige Dateien in Ihr lokales Repository übertragen haben, wird Ihr Workspace als "Zusammengeführt" markiert.
Alles was Sie tun müssen, ist ein Commit zu machen, um Ihr lokales Repository zu bestätigen, dass es sowohl Ihre Änderungen als auch die Änderungen anderer enthält.

*Mit dem GIT Command Line Client Interface:

<source lang="bash">
git pull
</source>

=Commit und Veröffentlichen von Änderungen=
Um alle Änderungen zu sehen, die Sie in Ihrem Arbeitsverzeichnis vorgenommen haben und die darauf warten, in Git hinzugefügt zu werden:

*Mit GIT Command Line Interface:

<source lang="bash">
git status
git diff subdir/filename
</source>

Um Änderungen, die Sie in Ihrem lokalen Repository vorgenommen haben, in den GIT-Index aufzunehmen, führen Sie einen commit-Befehl für diesen Index durch:

*Mit Eclipse: Klicken Sie mit der rechten Maustaste auf die zu übertragende Datei oder das Verzeichnis. Wählen Sie die Datei zum Hinzufügen/Entfernen/Aktualisieren in den nächsten Commit.
*Mit GIT Command Line Interface:

<source lang="bash">
git commit -a -m "Commit text"
</source>
Dadurch werden Hinzufügungen und Änderungen in Ihrem lokalen Branch gespeichert.

Um sie auf den GIT-Repository-Server zu pushen,

*With Eclipse: Klicken Sie mit der rechten Maustaste auf das Projekt und wählen Sie "'''Team - Push to Upstream'''".
*With GIT Command Line Interface:

<source lang="bash">
git push
</source>

Um ein Commit abzubrechen:

*Mit GIT Command Line Interface, wenn der Commit noch nicht gepusht wurde:

<source lang="bash">
git reset --soft HEAD~1
</source>

*With GIT Command Line Interface, if commit was already pushed:

<source lang="bash">
git revert IdCommit or git revert HEAD (for last commit)
</source>

To merge changes done into your forked GIT instance into official Dolibarr instance:

*Go into GitHub web interface of your forked Git instance.
*Click on small button "Create a Pull request".
*Choose commit you request inclusion and validate.

=Ask official project to include your changes=
Once you pushed one or several commit toward your distant fork area on github, you can ask the Dolibarr core team to include it into official project.
For this, follow this tutorial: https://help.github.com/articles/creating-a-pull-request/

=Add an external commit into current repository=
Some developers may work and do commit into their own Git repository after forking the project. If you are interesting into getting this changes, you can import them with the following steps.

You need both Eclipse and GIT Command Line interface to achieve this:

*First, go into GIT setup view and right click on "'''Remotes'''" of your Eclipse Git working space and choose "'''Create a remote...'''"
*Type name or remote fork the developer has create (in most cases, it's developer Git login). For example: "'''thedevlogin'''". Choose also "'''Configure Fetch'''".
*Type URI of Git repository of developer. For example: '''git://github.com/thedevlogin/dolibarr.git'''. Also add a refspec value to declare the branch you want to get. For example: '''refs/heads/master:refs/remotes/thedevlogin/master'''. Click "'''Save and Fetch'''". A new entry will be added into "Remote Tracking" making possible to read/get commits done into this branch.
Gehen Sie nun in die Kommandozeile Ihres Git-Repositorys (unter Linux ist es in den meisten Fällen '''/home/yourlogin/git/yourdolibarr''') und geben Sie den Befehl git cherry-pick ein:
<source lang="bash">
git cherry-pick -x commitid
</source>
wobei commitid der Wert der Commit-ID ist, die Sie erhalten möchten.

Sobald dies erledigt ist, gehen Sie zurück zu Eclipse und aktualisieren Sie das Projekt. Sie werden sehen, dass geänderte Dateien mit Dekoratoren erscheinen (mit Konflikten, wenn es welche gibt).

Wenn die Auswahl aufgrund von Konflikten fehlschlägt, können Sie den Versuch der Auswahl mit
<source lang="bash">
git cherry-pick --abort
</source>

=Einen Konflikt lösen=
Wenn eine Datei nach einem "Pull" als "Konflikt" markiert ist, öffnen Sie die Datei und bearbeiten Sie sie.
Rechercher la chaine "<<<<<<<<<<", vous verrez la partie de code en conflit entre "<<<<<<<<<" et ">>>>>>>>". Bearbeiten Sie die Codezeilen manuell, um das Endergebnis zu erhalten, indem Sie auch die "<<<<<<<<" et ">>>>>>>".

Klicken Sie dann mit der rechten Maustaste auf die Datei und wählen Sie " Hinzufügen".

Wenn Sie lieber alle Änderungen, die Sie an allen Dateien vorgenommen haben, vollständig rückgängig machen möchten (um Ihren Arbeitsbereich mit dem Inhalt des entfernten Repositoriums wiederherzustellen), können Sie einen Reset durchführen:

*Mit Eclipse klicken Sie mit der rechten Maustaste auf die oberste Zeile des Projekts und wählen Sie "Zurücksetzen" und dann "'''Hard'''" und dann "'''Reference - HEAD'''".
*Bei Verwendung des GIT-Befehlszeilentools erreichen Sie dies mit dem Befehl

<source lang="bash">
git reset --hard HEAD
</source>

=Taggen Sie die Quellen=
Mit den GIT-Kommandozeilenwerkzeugen:
Um ein Tag über eine Version zu erstellen:
<source lang="bash">
git tag -a -m "Release|Maintenance release x.y.z" "x.y.z"
oder
git tag -a -f -m "Beta x.y.betai" "x.y.betai_YYYYMMDD" idcommit # -f force wenn ein Tag bereits existiert, ermöglicht idcommit die Auswahl des zu taggenden Commits.
git push --tags # Pour pousser le tags sur le serveur distant
</source>

Um einen Tag zu löschen:
<source lang="bash">
git tag -d "x.y.z_YYYYMMDD"
git push origin :x.y.z_YYYYMMDD # Um die Löschung auf dem entfernten Server zu bestätigen
</source>

=Einen neue Branche erstellen=
Hier ist der Befehl, den Sie verwenden müssen, um einen neuen Zweig aus einem eigenen develop-Repository zu erstellen:
<source lang="bash">
git branch x.y
git push origin x.y
</source>

=Statistiken=
Mit den GIT-Kommandozeilenwerkzeugen:

Um die Anzahl der Änderungen zu zählen, die ein Entwickler zwischen Version x und y vorgenommen hat:

*Zuerst führen Sie "git merge-base" aus, um die ID des letzten gemeinsamen Commits zwischen x und y zu erfahren.

<source lang="bash">
git merge-base origin/3.1 origin/develop
</source>

*Dann führen Sie git log aus, um eine Liste aller Änderungen von der letzten gemeinsamen Übertragung bis zur letzten Übertragung zu erhalten.
<source lang="bash">
git log id_found_at_previous_step..HEAD
</source>

*Um die Gesamtzahl der hinzugefügten/gelöschten Zeilen zu ermitteln:
<source lang="bash">
git log --ancestry-path --numstat --pretty="%H" id_found_at_previous_step..HEAD | awk 'NF==3 {plus+=$1; minus+=$2} END {printf("+%d, -%d\n", plus, minus)}'
</source>

Zählen der endgültigen Änderungen zwischen einer Version x und y (dies unterscheidet sich von der vorherigen Zählung, da bei der vorherigen Zählung eine Änderung zweimal zu zwei verschiedenen Zeitpunkten durchgeführt werden kann, um unterschiedliche Änderungen vorzunehmen. Bei der zweiten Methode werden die Änderungen gezählt, die schließlich gefunden wurden, wenn die Änderungen beim ersten Versuch in Ordnung waren):

*Verwenden Sie die gleiche Methode wie zuvor, aber anstatt git log auszuführen, führen Sie '''git diff''' aus.

<source lang="bash">
git diff -b -M --numstat --pretty="%H" id_found_at_previous_step..HEAD | awk 'NF==3 {plus+=$1; minus+=$2} END {printf("+%d, -%d\n", plus, minus)}'
</source>

Weitere Informationen über die Verwendung von GIT erhältlich unter: [http://wiki.eclipse.org/EGit/User_Guide ici].

[[Category:Development]]

FAQ Get, update GIT Projekt Quellen

2022-09-24T09:13:40Z

Speaking services:

[[en:FAQ_Get,update_GIT_project_sources]]
[[fr:FAQ_Récupérer,_mettre_à_jour_les_sources_GIT_du_projet]]
[[es:FAQ_Recuperar,_actualizar_GIT_fuentes_del_proyecto]]


[[Category:FAQ DE]]
Hier finden Sie Informationen darüber, wie Sie die Quellen des Dolibarr-Projekts erhalten können.
Es werden mehrere Methoden beschrieben, aber wir empfehlen, die auf GitHub basierende Methode zu verwenden.

 

=Letzte Version der Quellen durch tgz-Download abrufen=
Diese Methode kann auch von nicht-technischen Benutzern verwendet werden.
Sie ermöglicht es Ihnen, die Quellen des Hauptentwicklungszweigs (HEAD genannt) zu erhalten, indem Sie einfach eine Datei herunterladen: Diese Operation besteht darin, die letzte Version der Dolibarr-Dateien zu erhalten, die jede Nacht in eine tgz-Datei gepackt werden. Die Datei ist über einen Link verfügbar:

{{LinkLastSnapshot}}

Neue Dateien überschreiben alte Dateien. Der Nachteil dieser Methode ist, dass Sie das Paket jedes Mal herunterladen und dekomprimieren müssen, wenn Sie Updates erhalten möchten.

Entwickler sollten diese Methode nicht verwenden, um Quellen zu erhalten, sondern die nächste.

=Letzte Version der Quellen über einen anonymen GIT-Zugang abrufen=
Sie können diese Methode verwenden, wenn Sie keinen GIT-Zugang haben. Mit dieser Methode können Sie keine Änderungen einreichen. Wenn Sie also ein Entwickler sind, sollten Sie ein GitHub-Konto erstellen und die nächste Methode anstelle dieser Methode verwenden.

==Voraussetzungen==

*Mit Eclipse IDE

Zuerst müssen Sie eine funktionierende Installation von Eclipse haben. Das '''EGit'''-Plugin muss ebenfalls installiert worden sein.
Verwenden Sie dazu den '''Find And Install process''' im Eclipse Menü, fügen Sie die GIT update URL hinzu:
https://download.eclipse.org/egit/updates
Wählen Sie dann '''EGit''' zur Installation aus (JGit muss nicht ausgewählt werden)

*Mit der GIT-Kommandozeilen-Client-Schnittstelle

Sie müssen den GIT-Client installieren (das GIT-Befehlszeilentool wird unter Linux mit "sudo apt-get install git" installiert, für Windows ist der GIT-Client unter https://git-scm.com/download/win zu finden).

==Clone Prozess==
Geben Sie zunächst den Wert des Repositorys mit den Referenzquellen in Ihr GIT-Client-Tool ein.

*Mit Eclipse, gehen Sie in die Perspektive GIT, klicken Sie auf den Button "GIT Repository klonen". Geben Sie die GIT-URL des Projekts ein, das Sie erhalten möchten.
<source lang="ini">
git://github.com/Dolibarr/dolibarr.git (read only)
oder wenn Sie einen Fork von dolibarr github von der github-Weboberfläche erstellt haben
git@github.com:yourgitaccount/dolibarr.git (read and write access)
</source>
Ihr Eclipse-GIT-Client wird Sie auffordern, die Branches auszuwählen, an denen Sie interessiert sind. Branches, die jetzt noch nicht ausgewählt sind, können später durch einen "Fetch" aus der "Remotes"-Ansicht ausgewählt werden, aber versuchen Sie, nur den Branch auszuwählen, den Sie benötigen. Dies erspart Ihnen später Zeit und Probleme.

Hinweis: Wenn Sie sich hinter einer Firewall befinden, müssen Sie die Eclipse-Proxy-Zugangsdaten im Eclipse-Menü Fenster - Einstellungen - Allgemein - Netzwerkverbindung einstellen und die alternative URL verwenden:
<source lang="ini">
https://gitlogin:gitpassword@github.com/yourgitaccount/dolibarr.git
</source>

*Mit GIT auf der Befehlszeilenschnittstelle:

Richten Sie zunächst Ihren Git-Client ein:
<source lang="bash">
git config --global user.name "Your Name"
git config --global user.email "user@domain.com"
git config --list
</source>
Dann klonen Sie das Repository lokal:
<source lang="bash">
git://github.com/Dolibarr/dolibarr.git (nur lesen)
oder wenn Sie einen Fork von dolibarr github von der github-Weboberfläche erstellt haben
git@github.com:yourgitaccount/dolibarr.git (Lese- und Schreibzugriff)
</source>

Hinweis: Wenn Sie sich hinter einer Firewall befinden, müssen Sie Ihre Proxy-Informationen einstellen und die alternative https-URL verwenden:
<source lang="bash">
git config --global http.proxy http://proxyuser:proxypass@proxyserver:proxyport
git clone https://gitlogin:gitpassword@github.com/yourgitaccount/dolibarr.git dolibarr
</source>

Sobald dieser Schritt bestätigt ist, lädt Ihr GIT-Client alle Dateien vom entfernten GIT-Server herunter. Dies kann einige Sekunden oder Minuten dauern.

Sobald der Download abgeschlossen ist, müssen Sie wählen, an welchem Zweig Sie arbeiten möchten.

*Mit GIT auf der Befehlszeilenschnittstelle;

<source lang="bash">
git checkout develop
git checkout x.y
</source>
Dadurch wird eine lokale Branche erstellt und automatisch ein Checkout durchgeführt.

*Klicken Sie in Eclipse mit der rechten Maustaste auf "Branches - Remotes -" die Branche, die Sie lokal duplizieren möchten".
Wählen Sie " Erstelle Branch" (und markieren Sie das Kästchen "Checkout"). Dadurch wird der Inhalt der Branche dupliziert, um lokal daran zu arbeiten, und Ihr "Arbeitsverzeichnis" wird aktualisiert, um an dieser Branche zu arbeiten.

Erstellen Sie ein Eclipse-Projekt:

Wenn Sie Eclipse verwenden, erstellen Sie, sobald die Verzweigung lokal erstellt wurde, ein PHP-Projekt aus dem Assistenten, indem Sie "'''Create from existing project'''" wählen und das Verzeichnis auswählen, das Ihr lokales GIT-Repository ist (Wählen Sie nicht die Option, ein PHP-Projekt komplett neu zu erstellen).

Klicken Sie dann mit der rechten Maustaste auf das Projekt in Ihrem Eclipse-Arbeitsbereich und wählen Sie "'''Team - Share'''". Wählen Sie GIT und klicken Sie auf die Option "'''Use or create repository in parent folder of project'''".
Eine alternative Methode ist File->Import, Git->Project von Git, Wählen Sie das Git-Repository und Weiter, Assistent für neue Projekte verwenden -> Php-Projekt, geben Sie den Ordner Ihres lokalen GIT-Repositorys ein.

Dann können Sie Eclipse so einstellen, dass es nicht alle Projektdateien für seine Build-Tools (Outline Scanner, TODO Scanner, Syntax Scanner...) scannt. Dies verhindert, dass Eclipse zu langsam ist. Klicken Sie dazu mit der rechten Maustaste auf das Projekt, wählen Sie Build Path und stellen Sie es wie im folgenden Screenshot ein.

[[File:Eclipse php build path.png|240px]]

=Abrufen der letzten Version der Quellen über einen GitHub-Nutzerzugang=
==Voraussetzung==

*Mit Eclipse IDE

Sie müssen zuvor ein Konto auf GitHub (https://github.com/) erstellen und ein öffentliches RSA- oder DSA-Zertifikat in Ihr Kontoprofil hochladen.

Dann müssen Sie eine funktionierende Installation von Eclipse haben. Das '''EGit'''-Plugin muss ebenfalls installiert worden sein.
https://download.eclipse.org/egit/updates
Wählen Sie dann die Installation von '''EGit'''.
*Mit der GIT-Kommandozeilen-Schnittstelle:

Sie müssen zuvor ein Konto auf GitHub (https://github.com/) erstellen und ein öffentliches RSA- oder DSA-Zertifikat in Ihr Kontoprofil hochladen.

Dann müssen Sie den GIT-Client installieren (GIT-Kommandozeilen-Tool unter Linux mit "sudo apt-get install git" oder den GIT-Client für Windows unter https://git-scm.com/download/win).

==Fork Prozess==
Melden Sie sich bei Github mit den Login-Daten an, das Sie im vorherigen Schritt erstellt haben. Gehen Sie dann auf die Seite

https://github.com/Dolibarr/dolibarr

und klicken Sie auf die Schaltfläche "Fork".

Dadurch wird eine Kopie (ein Fork) des Projekts in Ihrem eigenen Github-Bereich erstellt. Da Sie der Besitzer dieses Forks sind, haben Sie alle Rechte, die Sie für die nächsten Schritte benötigen.

==Clone Prozess==
Dann ist der Prozess derselbe wie bei der Beschaffung von Quellen mit anonymen Zugriff.

Die für den GIT-Clone zu verwendende URL ist dieselbe:
<source lang="ini">
git@github.com:YourGitHubLogin/dolibarr.git
</source>

Beachten Sie, dass es auch eine HTTPS-URL gibt, die aber manchmal offline ist (verwenden Sie also lieber die erste, ein Link mit HTTPS ist nur erforderlich, wenn Sie sich hinter einer Firewall befinden):

<source lang="ini">
https://yourgithublogin@github.com/Dolibarr/dolibarr.git
</source>

=Update des Repository=
So aktualisieren Sie Ihren lokalen Workspace:

*Mit Eclipse IDE:

Rechtsklick auf das Eclipse-Projekt und Auswahl von "Pull".

Wenn Sie in Ihrem Eclipse-Workspace Änderungen an Dateien vorgenommen haben, die in der GIT-Remote-Referenz geändert wurden, wird Ihr GIT-Client automatisch einen Merge durchführen.

*Wenn es Konflikte gibt, wird der Merge alle Konfliktdateien als "Konflikt" markieren (siehe später, um diesen Zustand zu lösen).
*Wenn nicht, erhalten Sie alle Dateien in der neuen Version, einschließlich aller Ihrer Änderungen.

Wenn Sie bereits einige Dateien in Ihr lokales Repository übertragen haben, wird Ihr Workspace als "Zusammengeführt" markiert.
Alles was Sie tun müssen, ist ein Commit zu machen, um Ihr lokales Repository zu bestätigen, dass es sowohl Ihre Änderungen als auch die Änderungen anderer enthält.

*Mit dem GIT Command Line Client Interface:

<source lang="bash">
git pull
</source>

=Commit und Veröffentlichen von Änderungen=
Um alle Änderungen zu sehen, die Sie in Ihrem Arbeitsverzeichnis vorgenommen haben und die darauf warten, in Git hinzugefügt zu werden:

*Mit GIT Command Line Interface:

<source lang="bash">
git status
git diff subdir/filename
</source>

Um Änderungen, die Sie in Ihrem lokalen Repository vorgenommen haben, in den GIT-Index aufzunehmen, führen Sie einen commit-Befehl für diesen Index durch:

*Mit Eclipse: Klicken Sie mit der rechten Maustaste auf die zu übertragende Datei oder das Verzeichnis. Wählen Sie die Datei zum Hinzufügen/Entfernen/Aktualisieren in den nächsten Commit.
*Mit GIT Command Line Interface:

<source lang="bash">
git commit -a -m "Commit text"
</source>
Dadurch werden Hinzufügungen und Änderungen in Ihrem lokalen Branch gespeichert.

Um sie auf den GIT-Repository-Server zu pushen,

*With Eclipse: Klicken Sie mit der rechten Maustaste auf das Projekt und wählen Sie "'''Team - Push to Upstream'''".
*With GIT Command Line Interface:

<source lang="bash">
git push
</source>

Um ein Commit abzubrechen:

*With GIT Command Line Interface, if commit was not already pushed:

<source lang="bash">
git reset --soft HEAD~1
</source>

*With GIT Command Line Interface, if commit was already pushed:

<source lang="bash">
git revert IdCommit or git revert HEAD (for last commit)
</source>

To merge changes done into your forked GIT instance into official Dolibarr instance:

*Go into GitHub web interface of your forked Git instance.
*Click on small button "Create a Pull request".
*Choose commit you request inclusion and validate.

=Ask official project to include your changes=
Once you pushed one or several commit toward your distant fork area on github, you can ask the Dolibarr core team to include it into official project.
For this, follow this tutorial: https://help.github.com/articles/creating-a-pull-request/

=Add an external commit into current repository=
Some developers may work and do commit into their own Git repository after forking the project. If you are interesting into getting this changes, you can import them with the following steps.

You need both Eclipse and GIT Command Line interface to achieve this:

*First, go into GIT setup view and right click on "'''Remotes'''" of your Eclipse Git working space and choose "'''Create a remote...'''"
*Type name or remote fork the developer has create (in most cases, it's developer Git login). For example: "'''thedevlogin'''". Choose also "'''Configure Fetch'''".
*Type URI of Git repository of developer. For example: '''git://github.com/thedevlogin/dolibarr.git'''. Also add a refspec value to declare the branch you want to get. For example: '''refs/heads/master:refs/remotes/thedevlogin/master'''. Click "'''Save and Fetch'''". A new entry will be added into "Remote Tracking" making possible to read/get commits done into this branch.
Gehen Sie nun in die Kommandozeile Ihres Git-Repositorys (unter Linux ist es in den meisten Fällen '''/home/yourlogin/git/yourdolibarr''') und geben Sie den Befehl git cherry-pick ein:
<source lang="bash">
git cherry-pick -x commitid
</source>
wobei commitid der Wert der Commit-ID ist, die Sie erhalten möchten.

Sobald dies erledigt ist, gehen Sie zurück zu Eclipse und aktualisieren Sie das Projekt. Sie werden sehen, dass geänderte Dateien mit Dekoratoren erscheinen (mit Konflikten, wenn es welche gibt).

Wenn die Auswahl aufgrund von Konflikten fehlschlägt, können Sie den Versuch der Auswahl mit
<source lang="bash">
git cherry-pick --abort
</source>

=Einen Konflikt lösen=
Wenn eine Datei nach einem "Pull" als "Konflikt" markiert ist, öffnen Sie die Datei und bearbeiten Sie sie.
Rechercher la chaine "<<<<<<<<<<", vous verrez la partie de code en conflit entre "<<<<<<<<<" et ">>>>>>>>". Bearbeiten Sie die Codezeilen manuell, um das Endergebnis zu erhalten, indem Sie auch die "<<<<<<<<" et ">>>>>>>".

Klicken Sie dann mit der rechten Maustaste auf die Datei und wählen Sie " Hinzufügen".

Wenn Sie lieber alle Änderungen, die Sie an allen Dateien vorgenommen haben, vollständig rückgängig machen möchten (um Ihren Arbeitsbereich mit dem Inhalt des entfernten Repositoriums wiederherzustellen), können Sie einen Reset durchführen:

*Mit Eclipse klicken Sie mit der rechten Maustaste auf die oberste Zeile des Projekts und wählen Sie "Zurücksetzen" und dann "'''Hard'''" und dann "'''Reference - HEAD'''".
*Bei Verwendung des GIT-Befehlszeilentools erreichen Sie dies mit dem Befehl

<source lang="bash">
git reset --hard HEAD
</source>

=Taggen Sie die Quellen=
Mit den GIT-Kommandozeilenwerkzeugen:
Um ein Tag über eine Version zu erstellen:
<source lang="bash">
git tag -a -m "Release|Maintenance release x.y.z" "x.y.z"
oder
git tag -a -f -m "Beta x.y.betai" "x.y.betai_YYYYMMDD" idcommit # -f force wenn ein Tag bereits existiert, ermöglicht idcommit die Auswahl des zu taggenden Commits.
git push --tags # Pour pousser le tags sur le serveur distant
</source>

Um einen Tag zu löschen:
<source lang="bash">
git tag -d "x.y.z_YYYYMMDD"
git push origin :x.y.z_YYYYMMDD # Um die Löschung auf dem entfernten Server zu bestätigen
</source>

=Einen neue Branche erstellen=
Hier ist der Befehl, den Sie verwenden müssen, um einen neuen Zweig aus einem eigenen develop-Repository zu erstellen:
<source lang="bash">
git branch x.y
git push origin x.y
</source>

=Statistiken=
Mit den GIT-Kommandozeilenwerkzeugen:

Um die Anzahl der Änderungen zu zählen, die ein Entwickler zwischen Version x und y vorgenommen hat:

*Zuerst führen Sie "git merge-base" aus, um die ID des letzten gemeinsamen Commits zwischen x und y zu erfahren.

<source lang="bash">
git merge-base origin/3.1 origin/develop
</source>

*Dann führen Sie git log aus, um eine Liste aller Änderungen von der letzten gemeinsamen Übertragung bis zur letzten Übertragung zu erhalten.
<source lang="bash">
git log id_found_at_previous_step..HEAD
</source>

*Um die Gesamtzahl der hinzugefügten/gelöschten Zeilen zu ermitteln:
<source lang="bash">
git log --ancestry-path --numstat --pretty="%H" id_found_at_previous_step..HEAD | awk 'NF==3 {plus+=$1; minus+=$2} END {printf("+%d, -%d\n", plus, minus)}'
</source>

Zählen der endgültigen Änderungen zwischen einer Version x und y (dies unterscheidet sich von der vorherigen Zählung, da bei der vorherigen Zählung eine Änderung zweimal zu zwei verschiedenen Zeitpunkten durchgeführt werden kann, um unterschiedliche Änderungen vorzunehmen. Bei der zweiten Methode werden die Änderungen gezählt, die schließlich gefunden wurden, wenn die Änderungen beim ersten Versuch in Ordnung waren):

*Verwenden Sie die gleiche Methode wie zuvor, aber anstatt git log auszuführen, führen Sie '''git diff''' aus.

<source lang="bash">
git diff -b -M --numstat --pretty="%H" id_found_at_previous_step..HEAD | awk 'NF==3 {plus+=$1; minus+=$2} END {printf("+%d, -%d\n", plus, minus)}'
</source>

Weitere Informationen über die Verwendung von GIT erhältlich unter: [http://wiki.eclipse.org/EGit/User_Guide ici].

[[Category:Development]]

FAQ Get, update GIT Projekt Quellen

2022-09-24T09:09:05Z

Speaking services: /* Commit und Veröffentlichen von Änderungen */

[[en:FAQ_Get,update_GIT_project_sources]]
[[fr:FAQ_Récupérer,_mettre_à_jour_les_sources_GIT_du_projet]]
[[es:FAQ_Recuperar,_actualizar_GIT_fuentes_del_proyecto]]


[[Category:FAQ DE]]
Hier finden Sie Informationen darüber, wie Sie die Quellen des Dolibarr-Projekts erhalten können.
Es werden mehrere Methoden beschrieben, aber wir empfehlen, die auf GitHub basierende Methode zu verwenden.

 

=Letzte Version der Quellen durch tgz-Download abrufen=
Diese Methode kann auch von nicht-technischen Benutzern verwendet werden.
Sie ermöglicht es Ihnen, die Quellen des Hauptentwicklungszweigs (HEAD genannt) zu erhalten, indem Sie einfach eine Datei herunterladen: Diese Operation besteht darin, die letzte Version der Dolibarr-Dateien zu erhalten, die jede Nacht in eine tgz-Datei gepackt werden. Die Datei ist über einen Link verfügbar:

{{LinkLastSnapshot}}

Neue Dateien überschreiben alte Dateien. Der Nachteil dieser Methode ist, dass Sie das Paket jedes Mal herunterladen und dekomprimieren müssen, wenn Sie Updates erhalten möchten.

Entwickler sollten diese Methode nicht verwenden, um Quellen zu erhalten, sondern die nächste.

=Letzte Version der Quellen über einen anonymen GIT-Zugang abrufen=
Sie können diese Methode verwenden, wenn Sie keinen GIT-Zugang haben. Mit dieser Methode können Sie keine Änderungen einreichen. Wenn Sie also ein Entwickler sind, sollten Sie ein GitHub-Konto erstellen und die nächste Methode anstelle dieser Methode verwenden.

==Voraussetzungen==

*Mit Eclipse IDE

Zuerst müssen Sie eine funktionierende Installation von Eclipse haben. Das '''EGit'''-Plugin muss ebenfalls installiert worden sein.
Verwenden Sie dazu den '''Find And Install process''' im Eclipse Menü, fügen Sie die GIT update URL hinzu:
https://download.eclipse.org/egit/updates
Wählen Sie dann '''EGit''' zur Installation aus (JGit muss nicht ausgewählt werden)

*Mit der GIT-Kommandozeilen-Client-Schnittstelle

Sie müssen den GIT-Client installieren (das GIT-Befehlszeilentool wird unter Linux mit "sudo apt-get install git" installiert, für Windows ist der GIT-Client unter https://git-scm.com/download/win zu finden).

==Clone Prozess==
Geben Sie zunächst den Wert des Repositorys mit den Referenzquellen in Ihr GIT-Client-Tool ein.

*Mit Eclipse, gehen Sie in die Perspektive GIT, klicken Sie auf den Button "GIT Repository klonen". Geben Sie die GIT-URL des Projekts ein, das Sie erhalten möchten.
<source lang="ini">
git://github.com/Dolibarr/dolibarr.git (read only)
oder wenn Sie einen Fork von dolibarr github von der github-Weboberfläche erstellt haben
git@github.com:yourgitaccount/dolibarr.git (read and write access)
</source>
Ihr Eclipse-GIT-Client wird Sie auffordern, die Branches auszuwählen, an denen Sie interessiert sind. Branches, die jetzt noch nicht ausgewählt sind, können später durch einen "Fetch" aus der "Remotes"-Ansicht ausgewählt werden, aber versuchen Sie, nur den Branch auszuwählen, den Sie benötigen. Dies erspart Ihnen später Zeit und Probleme.

Hinweis: Wenn Sie sich hinter einer Firewall befinden, müssen Sie die Eclipse-Proxy-Zugangsdaten im Eclipse-Menü Fenster - Einstellungen - Allgemein - Netzwerkverbindung einstellen und die alternative URL verwenden:
<source lang="ini">
https://gitlogin:gitpassword@github.com/yourgitaccount/dolibarr.git
</source>

*Mit GIT auf der Befehlszeilenschnittstelle:

Richten Sie zunächst Ihren Git-Client ein:
<source lang="bash">
git config --global user.name "Your Name"
git config --global user.email "user@domain.com"
git config --list
</source>
Dann klonen Sie das Repository lokal:
<source lang="bash">
git://github.com/Dolibarr/dolibarr.git (nur lesen)
oder wenn Sie einen Fork von dolibarr github von der github-Weboberfläche erstellt haben
git@github.com:yourgitaccount/dolibarr.git (Lese- und Schreibzugriff)
</source>

Hinweis: Wenn Sie sich hinter einer Firewall befinden, müssen Sie Ihre Proxy-Informationen einstellen und die alternative https-URL verwenden:
<source lang="bash">
git config --global http.proxy http://proxyuser:proxypass@proxyserver:proxyport
git clone https://gitlogin:gitpassword@github.com/yourgitaccount/dolibarr.git dolibarr
</source>

Sobald dieser Schritt bestätigt ist, lädt Ihr GIT-Client alle Dateien vom entfernten GIT-Server herunter. Dies kann einige Sekunden oder Minuten dauern.

Sobald der Download abgeschlossen ist, müssen Sie wählen, an welchem Zweig Sie arbeiten möchten.

*Mit GIT auf der Befehlszeilenschnittstelle;

<source lang="bash">
git checkout develop
git checkout x.y
</source>
Dadurch wird eine lokale Branche erstellt und automatisch ein Checkout durchgeführt.

*Klicken Sie in Eclipse mit der rechten Maustaste auf "Branches - Remotes -" die Branche, die Sie lokal duplizieren möchten".
Wählen Sie " Erstelle Branch" (und markieren Sie das Kästchen "Checkout"). Dadurch wird der Inhalt der Branche dupliziert, um lokal daran zu arbeiten, und Ihr "Arbeitsverzeichnis" wird aktualisiert, um an dieser Branche zu arbeiten.

Erstellen Sie ein Eclipse-Projekt:

Wenn Sie Eclipse verwenden, erstellen Sie, sobald die Verzweigung lokal erstellt wurde, ein PHP-Projekt aus dem Assistenten, indem Sie "'''Create from existing project'''" wählen und das Verzeichnis auswählen, das Ihr lokales GIT-Repository ist (Wählen Sie nicht die Option, ein PHP-Projekt komplett neu zu erstellen).

Klicken Sie dann mit der rechten Maustaste auf das Projekt in Ihrem Eclipse-Arbeitsbereich und wählen Sie "'''Team - Share'''". Wählen Sie GIT und klicken Sie auf die Option "'''Use or create repository in parent folder of project'''".
Eine alternative Methode ist File->Import, Git->Project von Git, Wählen Sie das Git-Repository und Weiter, Assistent für neue Projekte verwenden -> Php-Projekt, geben Sie den Ordner Ihres lokalen GIT-Repositorys ein.

Dann können Sie Eclipse so einstellen, dass es nicht alle Projektdateien für seine Build-Tools (Outline Scanner, TODO Scanner, Syntax Scanner...) scannt. Dies verhindert, dass Eclipse zu langsam ist. Klicken Sie dazu mit der rechten Maustaste auf das Projekt, wählen Sie Build Path und stellen Sie es wie im folgenden Screenshot ein.

[[File:Eclipse php build path.png|240px]]

=Abrufen der letzten Version der Quellen über einen GitHub-Nutzerzugang=
==Voraussetzung==

*Mit Eclipse IDE

Sie müssen zuvor ein Konto auf GitHub (https://github.com/) erstellen und ein öffentliches RSA- oder DSA-Zertifikat in Ihr Kontoprofil hochladen.

Dann müssen Sie eine funktionierende Installation von Eclipse haben. Das '''EGit'''-Plugin muss ebenfalls installiert worden sein.
https://download.eclipse.org/egit/updates
Wählen Sie dann die Installation von '''EGit'''.
*Mit der GIT-Kommandozeilen-Schnittstelle:

Sie müssen zuvor ein Konto auf GitHub (https://github.com/) erstellen und ein öffentliches RSA- oder DSA-Zertifikat in Ihr Kontoprofil hochladen.

Dann müssen Sie den GIT-Client installieren (GIT-Kommandozeilen-Tool unter Linux mit "sudo apt-get install git" oder den GIT-Client für Windows unter https://git-scm.com/download/win).

==Fork Prozess==
Melden Sie sich bei Github mit den Login-Daten an, das Sie im vorherigen Schritt erstellt haben. Gehen Sie dann auf die Seite

https://github.com/Dolibarr/dolibarr

und klicken Sie auf die Schaltfläche "Fork".

Dadurch wird eine Kopie (ein Fork) des Projekts in Ihrem eigenen Github-Bereich erstellt. Da Sie der Besitzer dieses Forks sind, haben Sie alle Rechte, die Sie für die nächsten Schritte benötigen.

==Clone Prozess==
Dann ist der Prozess derselbe wie bei der Beschaffung von Quellen mit anonymen Zugriff.

Die für den GIT-Clone zu verwendende URL ist dieselbe:
<source lang="ini">
git@github.com:YourGitHubLogin/dolibarr.git
</source>

Beachten Sie, dass es auch eine HTTPS-URL gibt, die aber manchmal offline ist (verwenden Sie also lieber die erste, ein Link mit HTTPS ist nur erforderlich, wenn Sie sich hinter einer Firewall befinden):

<source lang="ini">
https://yourgithublogin@github.com/Dolibarr/dolibarr.git
</source>

=Update des Repository=
So aktualisieren Sie Ihren lokalen Workspace:

*Mit Eclipse IDE:

Rechtsklick auf das Eclipse-Projekt und Auswahl von "Pull".

Wenn Sie in Ihrem Eclipse-Workspace Änderungen an Dateien vorgenommen haben, die in der GIT-Remote-Referenz geändert wurden, wird Ihr GIT-Client automatisch einen Merge durchführen.

*Wenn es Konflikte gibt, wird der Merge alle Konfliktdateien als "Konflikt" markieren (siehe später, um diesen Zustand zu lösen).
*Wenn nicht, erhalten Sie alle Dateien in der neuen Version, einschließlich aller Ihrer Änderungen.

Wenn Sie bereits einige Dateien in Ihr lokales Repository übertragen haben, wird Ihr Workspace als "Zusammengeführt" markiert.
Alles was Sie tun müssen, ist ein Commit zu machen, um Ihr lokales Repository zu bestätigen, dass es sowohl Ihre Änderungen als auch die Änderungen anderer enthält.

*Mit dem GIT Command Line Client Interface:

<source lang="bash">
git pull
</source>

=Commit und Veröffentlichen von Änderungen=
Um alle Änderungen zu sehen, die Sie in Ihrem Arbeitsverzeichnis vorgenommen haben und die darauf warten, in Git hinzugefügt zu werden:

*Mit GIT Command Line Interface:

<source lang="bash">
git status
git diff subdir/filename
</source>

Um Änderungen, die Sie in Ihrem lokalen Repository vorgenommen haben, in den GIT-Index aufzunehmen, führen Sie einen commit-Befehl für diesen Index durch:

*Mit Eclipse: Klicken Sie mit der rechten Maustaste auf die zu übertragende Datei oder das Verzeichnis. Wählen Sie die Datei zum Hinzufügen/Entfernen/Aktualisieren in den nächsten Commit.
*Mit GIT Command Line Interface:

<source lang="bash">
git commit -a -m "Commit text"
</source>
This will save add and changes into your local branch.

To push them on the GIT repository server,

*With Eclipse: right click on project and choose "'''Team - Push to Upstream'''".
*With GIT Command Line Interface:

<source lang="bash">
git push
</source>

To cancel a commit:

*With GIT Command Line Interface, if commit was not already pushed:

<source lang="bash">
git reset --soft HEAD~1
</source>

*With GIT Command Line Interface, if commit was already pushed:

<source lang="bash">
git revert IdCommit or git revert HEAD (for last commit)
</source>

To merge changes done into your forked GIT instance into official Dolibarr instance:

*Go into GitHub web interface of your forked Git instance.
*Click on small button "Create a Pull request".
*Choose commit you request inclusion and validate.

=Ask official project to include your changes=
Once you pushed one or several commit toward your distant fork area on github, you can ask the Dolibarr core team to include it into official project.
For this, follow this tutorial: https://help.github.com/articles/creating-a-pull-request/

=Add an external commit into current repository=
Some developers may work and do commit into their own Git repository after forking the project. If you are interesting into getting this changes, you can import them with the following steps.

You need both Eclipse and GIT Command Line interface to achieve this:

*First, go into GIT setup view and right click on "'''Remotes'''" of your Eclipse Git working space and choose "'''Create a remote...'''"
*Type name or remote fork the developer has create (in most cases, it's developer Git login). For example: "'''thedevlogin'''". Choose also "'''Configure Fetch'''".
*Type URI of Git repository of developer. For example: '''git://github.com/thedevlogin/dolibarr.git'''. Also add a refspec value to declare the branch you want to get. For example: '''refs/heads/master:refs/remotes/thedevlogin/master'''. Click "'''Save and Fetch'''". A new entry will be added into "Remote Tracking" making possible to read/get commits done into this branch.
Gehen Sie nun in die Kommandozeile Ihres Git-Repositorys (unter Linux ist es in den meisten Fällen '''/home/yourlogin/git/yourdolibarr''') und geben Sie den Befehl git cherry-pick ein:
<source lang="bash">
git cherry-pick -x commitid
</source>
wobei commitid der Wert der Commit-ID ist, die Sie erhalten möchten.

Sobald dies erledigt ist, gehen Sie zurück zu Eclipse und aktualisieren Sie das Projekt. Sie werden sehen, dass geänderte Dateien mit Dekoratoren erscheinen (mit Konflikten, wenn es welche gibt).

Wenn die Auswahl aufgrund von Konflikten fehlschlägt, können Sie den Versuch der Auswahl mit
<source lang="bash">
git cherry-pick --abort
</source>

=Einen Konflikt lösen=
Wenn eine Datei nach einem "Pull" als "Konflikt" markiert ist, öffnen Sie die Datei und bearbeiten Sie sie.
Rechercher la chaine "<<<<<<<<<<", vous verrez la partie de code en conflit entre "<<<<<<<<<" et ">>>>>>>>". Bearbeiten Sie die Codezeilen manuell, um das Endergebnis zu erhalten, indem Sie auch die "<<<<<<<<" et ">>>>>>>".

Klicken Sie dann mit der rechten Maustaste auf die Datei und wählen Sie " Hinzufügen".

Wenn Sie lieber alle Änderungen, die Sie an allen Dateien vorgenommen haben, vollständig rückgängig machen möchten (um Ihren Arbeitsbereich mit dem Inhalt des entfernten Repositoriums wiederherzustellen), können Sie einen Reset durchführen:

*Mit Eclipse klicken Sie mit der rechten Maustaste auf die oberste Zeile des Projekts und wählen Sie "Zurücksetzen" und dann "'''Hard'''" und dann "'''Reference - HEAD'''".
*Bei Verwendung des GIT-Befehlszeilentools erreichen Sie dies mit dem Befehl

<source lang="bash">
git reset --hard HEAD
</source>

=Taggen Sie die Quellen=
Mit den GIT-Kommandozeilenwerkzeugen:
Um ein Tag über eine Version zu erstellen:
<source lang="bash">
git tag -a -m "Release|Maintenance release x.y.z" "x.y.z"
oder
git tag -a -f -m "Beta x.y.betai" "x.y.betai_YYYYMMDD" idcommit # -f force wenn ein Tag bereits existiert, ermöglicht idcommit die Auswahl des zu taggenden Commits.
git push --tags # Pour pousser le tags sur le serveur distant
</source>

Um einen Tag zu löschen:
<source lang="bash">
git tag -d "x.y.z_YYYYMMDD"
git push origin :x.y.z_YYYYMMDD # Um die Löschung auf dem entfernten Server zu bestätigen
</source>

=Einen neue Branche erstellen=
Hier ist der Befehl, den Sie verwenden müssen, um einen neuen Zweig aus einem eigenen develop-Repository zu erstellen:
<source lang="bash">
git branch x.y
git push origin x.y
</source>

=Statistiken=
Mit den GIT-Kommandozeilenwerkzeugen:

Um die Anzahl der Änderungen zu zählen, die ein Entwickler zwischen Version x und y vorgenommen hat:

*Zuerst führen Sie "git merge-base" aus, um die ID des letzten gemeinsamen Commits zwischen x und y zu erfahren.

<source lang="bash">
git merge-base origin/3.1 origin/develop
</source>

*Dann führen Sie git log aus, um eine Liste aller Änderungen von der letzten gemeinsamen Übertragung bis zur letzten Übertragung zu erhalten.
<source lang="bash">
git log id_found_at_previous_step..HEAD
</source>

*Um die Gesamtzahl der hinzugefügten/gelöschten Zeilen zu ermitteln:
<source lang="bash">
git log --ancestry-path --numstat --pretty="%H" id_found_at_previous_step..HEAD | awk 'NF==3 {plus+=$1; minus+=$2} END {printf("+%d, -%d\n", plus, minus)}'
</source>

Zählen der endgültigen Änderungen zwischen einer Version x und y (dies unterscheidet sich von der vorherigen Zählung, da bei der vorherigen Zählung eine Änderung zweimal zu zwei verschiedenen Zeitpunkten durchgeführt werden kann, um unterschiedliche Änderungen vorzunehmen. Bei der zweiten Methode werden die Änderungen gezählt, die schließlich gefunden wurden, wenn die Änderungen beim ersten Versuch in Ordnung waren):

*Verwenden Sie die gleiche Methode wie zuvor, aber anstatt git log auszuführen, führen Sie '''git diff''' aus.

<source lang="bash">
git diff -b -M --numstat --pretty="%H" id_found_at_previous_step..HEAD | awk 'NF==3 {plus+=$1; minus+=$2} END {printf("+%d, -%d\n", plus, minus)}'
</source>

Weitere Informationen über die Verwendung von GIT erhältlich unter: [http://wiki.eclipse.org/EGit/User_Guide ici].

[[Category:Development]]

FAQ Get, update GIT Projekt Quellen

2022-09-24T09:06:26Z

Speaking services: /* Commit and publish your changes */

[[en:FAQ_Get,update_GIT_project_sources]]
[[fr:FAQ_Récupérer,_mettre_à_jour_les_sources_GIT_du_projet]]
[[es:FAQ_Recuperar,_actualizar_GIT_fuentes_del_proyecto]]


[[Category:FAQ DE]]
Hier finden Sie Informationen darüber, wie Sie die Quellen des Dolibarr-Projekts erhalten können.
Es werden mehrere Methoden beschrieben, aber wir empfehlen, die auf GitHub basierende Methode zu verwenden.

 

=Letzte Version der Quellen durch tgz-Download abrufen=
Diese Methode kann auch von nicht-technischen Benutzern verwendet werden.
Sie ermöglicht es Ihnen, die Quellen des Hauptentwicklungszweigs (HEAD genannt) zu erhalten, indem Sie einfach eine Datei herunterladen: Diese Operation besteht darin, die letzte Version der Dolibarr-Dateien zu erhalten, die jede Nacht in eine tgz-Datei gepackt werden. Die Datei ist über einen Link verfügbar:

{{LinkLastSnapshot}}

Neue Dateien überschreiben alte Dateien. Der Nachteil dieser Methode ist, dass Sie das Paket jedes Mal herunterladen und dekomprimieren müssen, wenn Sie Updates erhalten möchten.

Entwickler sollten diese Methode nicht verwenden, um Quellen zu erhalten, sondern die nächste.

=Letzte Version der Quellen über einen anonymen GIT-Zugang abrufen=
Sie können diese Methode verwenden, wenn Sie keinen GIT-Zugang haben. Mit dieser Methode können Sie keine Änderungen einreichen. Wenn Sie also ein Entwickler sind, sollten Sie ein GitHub-Konto erstellen und die nächste Methode anstelle dieser Methode verwenden.

==Voraussetzungen==

*Mit Eclipse IDE

Zuerst müssen Sie eine funktionierende Installation von Eclipse haben. Das '''EGit'''-Plugin muss ebenfalls installiert worden sein.
Verwenden Sie dazu den '''Find And Install process''' im Eclipse Menü, fügen Sie die GIT update URL hinzu:
https://download.eclipse.org/egit/updates
Wählen Sie dann '''EGit''' zur Installation aus (JGit muss nicht ausgewählt werden)

*Mit der GIT-Kommandozeilen-Client-Schnittstelle

Sie müssen den GIT-Client installieren (das GIT-Befehlszeilentool wird unter Linux mit "sudo apt-get install git" installiert, für Windows ist der GIT-Client unter https://git-scm.com/download/win zu finden).

==Clone Prozess==
Geben Sie zunächst den Wert des Repositorys mit den Referenzquellen in Ihr GIT-Client-Tool ein.

*Mit Eclipse, gehen Sie in die Perspektive GIT, klicken Sie auf den Button "GIT Repository klonen". Geben Sie die GIT-URL des Projekts ein, das Sie erhalten möchten.
<source lang="ini">
git://github.com/Dolibarr/dolibarr.git (read only)
oder wenn Sie einen Fork von dolibarr github von der github-Weboberfläche erstellt haben
git@github.com:yourgitaccount/dolibarr.git (read and write access)
</source>
Ihr Eclipse-GIT-Client wird Sie auffordern, die Branches auszuwählen, an denen Sie interessiert sind. Branches, die jetzt noch nicht ausgewählt sind, können später durch einen "Fetch" aus der "Remotes"-Ansicht ausgewählt werden, aber versuchen Sie, nur den Branch auszuwählen, den Sie benötigen. Dies erspart Ihnen später Zeit und Probleme.

Hinweis: Wenn Sie sich hinter einer Firewall befinden, müssen Sie die Eclipse-Proxy-Zugangsdaten im Eclipse-Menü Fenster - Einstellungen - Allgemein - Netzwerkverbindung einstellen und die alternative URL verwenden:
<source lang="ini">
https://gitlogin:gitpassword@github.com/yourgitaccount/dolibarr.git
</source>

*Mit GIT auf der Befehlszeilenschnittstelle:

Richten Sie zunächst Ihren Git-Client ein:
<source lang="bash">
git config --global user.name "Your Name"
git config --global user.email "user@domain.com"
git config --list
</source>
Dann klonen Sie das Repository lokal:
<source lang="bash">
git://github.com/Dolibarr/dolibarr.git (nur lesen)
oder wenn Sie einen Fork von dolibarr github von der github-Weboberfläche erstellt haben
git@github.com:yourgitaccount/dolibarr.git (Lese- und Schreibzugriff)
</source>

Hinweis: Wenn Sie sich hinter einer Firewall befinden, müssen Sie Ihre Proxy-Informationen einstellen und die alternative https-URL verwenden:
<source lang="bash">
git config --global http.proxy http://proxyuser:proxypass@proxyserver:proxyport
git clone https://gitlogin:gitpassword@github.com/yourgitaccount/dolibarr.git dolibarr
</source>

Sobald dieser Schritt bestätigt ist, lädt Ihr GIT-Client alle Dateien vom entfernten GIT-Server herunter. Dies kann einige Sekunden oder Minuten dauern.

Sobald der Download abgeschlossen ist, müssen Sie wählen, an welchem Zweig Sie arbeiten möchten.

*Mit GIT auf der Befehlszeilenschnittstelle;

<source lang="bash">
git checkout develop
git checkout x.y
</source>
Dadurch wird eine lokale Branche erstellt und automatisch ein Checkout durchgeführt.

*Klicken Sie in Eclipse mit der rechten Maustaste auf "Branches - Remotes -" die Branche, die Sie lokal duplizieren möchten".
Wählen Sie " Erstelle Branch" (und markieren Sie das Kästchen "Checkout"). Dadurch wird der Inhalt der Branche dupliziert, um lokal daran zu arbeiten, und Ihr "Arbeitsverzeichnis" wird aktualisiert, um an dieser Branche zu arbeiten.

Erstellen Sie ein Eclipse-Projekt:

Wenn Sie Eclipse verwenden, erstellen Sie, sobald die Verzweigung lokal erstellt wurde, ein PHP-Projekt aus dem Assistenten, indem Sie "'''Create from existing project'''" wählen und das Verzeichnis auswählen, das Ihr lokales GIT-Repository ist (Wählen Sie nicht die Option, ein PHP-Projekt komplett neu zu erstellen).

Klicken Sie dann mit der rechten Maustaste auf das Projekt in Ihrem Eclipse-Arbeitsbereich und wählen Sie "'''Team - Share'''". Wählen Sie GIT und klicken Sie auf die Option "'''Use or create repository in parent folder of project'''".
Eine alternative Methode ist File->Import, Git->Project von Git, Wählen Sie das Git-Repository und Weiter, Assistent für neue Projekte verwenden -> Php-Projekt, geben Sie den Ordner Ihres lokalen GIT-Repositorys ein.

Dann können Sie Eclipse so einstellen, dass es nicht alle Projektdateien für seine Build-Tools (Outline Scanner, TODO Scanner, Syntax Scanner...) scannt. Dies verhindert, dass Eclipse zu langsam ist. Klicken Sie dazu mit der rechten Maustaste auf das Projekt, wählen Sie Build Path und stellen Sie es wie im folgenden Screenshot ein.

[[File:Eclipse php build path.png|240px]]

=Abrufen der letzten Version der Quellen über einen GitHub-Nutzerzugang=
==Voraussetzung==

*Mit Eclipse IDE

Sie müssen zuvor ein Konto auf GitHub (https://github.com/) erstellen und ein öffentliches RSA- oder DSA-Zertifikat in Ihr Kontoprofil hochladen.

Dann müssen Sie eine funktionierende Installation von Eclipse haben. Das '''EGit'''-Plugin muss ebenfalls installiert worden sein.
https://download.eclipse.org/egit/updates
Wählen Sie dann die Installation von '''EGit'''.
*Mit der GIT-Kommandozeilen-Schnittstelle:

Sie müssen zuvor ein Konto auf GitHub (https://github.com/) erstellen und ein öffentliches RSA- oder DSA-Zertifikat in Ihr Kontoprofil hochladen.

Dann müssen Sie den GIT-Client installieren (GIT-Kommandozeilen-Tool unter Linux mit "sudo apt-get install git" oder den GIT-Client für Windows unter https://git-scm.com/download/win).

==Fork Prozess==
Melden Sie sich bei Github mit den Login-Daten an, das Sie im vorherigen Schritt erstellt haben. Gehen Sie dann auf die Seite

https://github.com/Dolibarr/dolibarr

und klicken Sie auf die Schaltfläche "Fork".

Dadurch wird eine Kopie (ein Fork) des Projekts in Ihrem eigenen Github-Bereich erstellt. Da Sie der Besitzer dieses Forks sind, haben Sie alle Rechte, die Sie für die nächsten Schritte benötigen.

==Clone Prozess==
Dann ist der Prozess derselbe wie bei der Beschaffung von Quellen mit anonymen Zugriff.

Die für den GIT-Clone zu verwendende URL ist dieselbe:
<source lang="ini">
git@github.com:YourGitHubLogin/dolibarr.git
</source>

Beachten Sie, dass es auch eine HTTPS-URL gibt, die aber manchmal offline ist (verwenden Sie also lieber die erste, ein Link mit HTTPS ist nur erforderlich, wenn Sie sich hinter einer Firewall befinden):

<source lang="ini">
https://yourgithublogin@github.com/Dolibarr/dolibarr.git
</source>

=Update des Repository=
So aktualisieren Sie Ihren lokalen Workspace:

*Mit Eclipse IDE:

Rechtsklick auf das Eclipse-Projekt und Auswahl von "Pull".

Wenn Sie in Ihrem Eclipse-Workspace Änderungen an Dateien vorgenommen haben, die in der GIT-Remote-Referenz geändert wurden, wird Ihr GIT-Client automatisch einen Merge durchführen.

*Wenn es Konflikte gibt, wird der Merge alle Konfliktdateien als "Konflikt" markieren (siehe später, um diesen Zustand zu lösen).
*Wenn nicht, erhalten Sie alle Dateien in der neuen Version, einschließlich aller Ihrer Änderungen.

Wenn Sie bereits einige Dateien in Ihr lokales Repository übertragen haben, wird Ihr Workspace als "Zusammengeführt" markiert.
Alles was Sie tun müssen, ist ein Commit zu machen, um Ihr lokales Repository zu bestätigen, dass es sowohl Ihre Änderungen als auch die Änderungen anderer enthält.

*Mit dem GIT Command Line Client Interface:

<source lang="bash">
git pull
</source>

=Commit und Veröffentlichen von Änderungen=
Um alle Änderungen zu sehen, die Sie in Ihrem Arbeitsverzeichnis vorgenommen haben und die darauf warten, in Git hinzugefügt zu werden:

*Mit GIT Command Line Interface:

<source lang="bash">
git status
git diff subdir/filename
</source>

To add changes made into your local repository into the GIT index, then commit this index :

*With Eclipse: Right click on file or directory to commit. Select file to add/remove/update into commit.
*With GIT Command Line Interface:

<source lang="bash">
git commit -a -m "Commit text"
</source>
This will save add and changes into your local branch.

To push them on the GIT repository server,

*With Eclipse: right click on project and choose "'''Team - Push to Upstream'''".
*With GIT Command Line Interface:

<source lang="bash">
git push
</source>

To cancel a commit:

*With GIT Command Line Interface, if commit was not already pushed:

<source lang="bash">
git reset --soft HEAD~1
</source>

*With GIT Command Line Interface, if commit was already pushed:

<source lang="bash">
git revert IdCommit or git revert HEAD (for last commit)
</source>

To merge changes done into your forked GIT instance into official Dolibarr instance:

*Go into GitHub web interface of your forked Git instance.
*Click on small button "Create a Pull request".
*Choose commit you request inclusion and validate.

=Ask official project to include your changes=
Once you pushed one or several commit toward your distant fork area on github, you can ask the Dolibarr core team to include it into official project.
For this, follow this tutorial: https://help.github.com/articles/creating-a-pull-request/

=Add an external commit into current repository=
Some developers may work and do commit into their own Git repository after forking the project. If you are interesting into getting this changes, you can import them with the following steps.

You need both Eclipse and GIT Command Line interface to achieve this:

*First, go into GIT setup view and right click on "'''Remotes'''" of your Eclipse Git working space and choose "'''Create a remote...'''"
*Type name or remote fork the developer has create (in most cases, it's developer Git login). For example: "'''thedevlogin'''". Choose also "'''Configure Fetch'''".
*Type URI of Git repository of developer. For example: '''git://github.com/thedevlogin/dolibarr.git'''. Also add a refspec value to declare the branch you want to get. For example: '''refs/heads/master:refs/remotes/thedevlogin/master'''. Click "'''Save and Fetch'''". A new entry will be added into "Remote Tracking" making possible to read/get commits done into this branch.
Gehen Sie nun in die Kommandozeile Ihres Git-Repositorys (unter Linux ist es in den meisten Fällen '''/home/yourlogin/git/yourdolibarr''') und geben Sie den Befehl git cherry-pick ein:
<source lang="bash">
git cherry-pick -x commitid
</source>
wobei commitid der Wert der Commit-ID ist, die Sie erhalten möchten.

Sobald dies erledigt ist, gehen Sie zurück zu Eclipse und aktualisieren Sie das Projekt. Sie werden sehen, dass geänderte Dateien mit Dekoratoren erscheinen (mit Konflikten, wenn es welche gibt).

Wenn die Auswahl aufgrund von Konflikten fehlschlägt, können Sie den Versuch der Auswahl mit
<source lang="bash">
git cherry-pick --abort
</source>

=Einen Konflikt lösen=
Wenn eine Datei nach einem "Pull" als "Konflikt" markiert ist, öffnen Sie die Datei und bearbeiten Sie sie.
Rechercher la chaine "<<<<<<<<<<", vous verrez la partie de code en conflit entre "<<<<<<<<<" et ">>>>>>>>". Bearbeiten Sie die Codezeilen manuell, um das Endergebnis zu erhalten, indem Sie auch die "<<<<<<<<" et ">>>>>>>".

Klicken Sie dann mit der rechten Maustaste auf die Datei und wählen Sie " Hinzufügen".

Wenn Sie lieber alle Änderungen, die Sie an allen Dateien vorgenommen haben, vollständig rückgängig machen möchten (um Ihren Arbeitsbereich mit dem Inhalt des entfernten Repositoriums wiederherzustellen), können Sie einen Reset durchführen:

*Mit Eclipse klicken Sie mit der rechten Maustaste auf die oberste Zeile des Projekts und wählen Sie "Zurücksetzen" und dann "'''Hard'''" und dann "'''Reference - HEAD'''".
*Bei Verwendung des GIT-Befehlszeilentools erreichen Sie dies mit dem Befehl

<source lang="bash">
git reset --hard HEAD
</source>

=Taggen Sie die Quellen=
Mit den GIT-Kommandozeilenwerkzeugen:
Um ein Tag über eine Version zu erstellen:
<source lang="bash">
git tag -a -m "Release|Maintenance release x.y.z" "x.y.z"
oder
git tag -a -f -m "Beta x.y.betai" "x.y.betai_YYYYMMDD" idcommit # -f force wenn ein Tag bereits existiert, ermöglicht idcommit die Auswahl des zu taggenden Commits.
git push --tags # Pour pousser le tags sur le serveur distant
</source>

Um einen Tag zu löschen:
<source lang="bash">
git tag -d "x.y.z_YYYYMMDD"
git push origin :x.y.z_YYYYMMDD # Um die Löschung auf dem entfernten Server zu bestätigen
</source>

=Einen neue Branche erstellen=
Hier ist der Befehl, den Sie verwenden müssen, um einen neuen Zweig aus einem eigenen develop-Repository zu erstellen:
<source lang="bash">
git branch x.y
git push origin x.y
</source>

=Statistiken=
Mit den GIT-Kommandozeilenwerkzeugen:

Um die Anzahl der Änderungen zu zählen, die ein Entwickler zwischen Version x und y vorgenommen hat:

*Zuerst führen Sie "git merge-base" aus, um die ID des letzten gemeinsamen Commits zwischen x und y zu erfahren.

<source lang="bash">
git merge-base origin/3.1 origin/develop
</source>

*Dann führen Sie git log aus, um eine Liste aller Änderungen von der letzten gemeinsamen Übertragung bis zur letzten Übertragung zu erhalten.
<source lang="bash">
git log id_found_at_previous_step..HEAD
</source>

*Um die Gesamtzahl der hinzugefügten/gelöschten Zeilen zu ermitteln:
<source lang="bash">
git log --ancestry-path --numstat --pretty="%H" id_found_at_previous_step..HEAD | awk 'NF==3 {plus+=$1; minus+=$2} END {printf("+%d, -%d\n", plus, minus)}'
</source>

Zählen der endgültigen Änderungen zwischen einer Version x und y (dies unterscheidet sich von der vorherigen Zählung, da bei der vorherigen Zählung eine Änderung zweimal zu zwei verschiedenen Zeitpunkten durchgeführt werden kann, um unterschiedliche Änderungen vorzunehmen. Bei der zweiten Methode werden die Änderungen gezählt, die schließlich gefunden wurden, wenn die Änderungen beim ersten Versuch in Ordnung waren):

*Verwenden Sie die gleiche Methode wie zuvor, aber anstatt git log auszuführen, führen Sie '''git diff''' aus.

<source lang="bash">
git diff -b -M --numstat --pretty="%H" id_found_at_previous_step..HEAD | awk 'NF==3 {plus+=$1; minus+=$2} END {printf("+%d, -%d\n", plus, minus)}'
</source>

Weitere Informationen über die Verwendung von GIT erhältlich unter: [http://wiki.eclipse.org/EGit/User_Guide ici].

[[Category:Development]]

FAQ Get, update GIT Projekt Quellen

2022-09-24T07:25:12Z

Speaking services: /* Update your repository */

[[en:FAQ_Get,update_GIT_project_sources]]
[[fr:FAQ_Récupérer,_mettre_à_jour_les_sources_GIT_du_projet]]
[[es:FAQ_Recuperar,_actualizar_GIT_fuentes_del_proyecto]]


[[Category:FAQ DE]]
Hier finden Sie Informationen darüber, wie Sie die Quellen des Dolibarr-Projekts erhalten können.
Es werden mehrere Methoden beschrieben, aber wir empfehlen, die auf GitHub basierende Methode zu verwenden.

 

=Letzte Version der Quellen durch tgz-Download abrufen=
Diese Methode kann auch von nicht-technischen Benutzern verwendet werden.
Sie ermöglicht es Ihnen, die Quellen des Hauptentwicklungszweigs (HEAD genannt) zu erhalten, indem Sie einfach eine Datei herunterladen: Diese Operation besteht darin, die letzte Version der Dolibarr-Dateien zu erhalten, die jede Nacht in eine tgz-Datei gepackt werden. Die Datei ist über einen Link verfügbar:

{{LinkLastSnapshot}}

Neue Dateien überschreiben alte Dateien. Der Nachteil dieser Methode ist, dass Sie das Paket jedes Mal herunterladen und dekomprimieren müssen, wenn Sie Updates erhalten möchten.

Entwickler sollten diese Methode nicht verwenden, um Quellen zu erhalten, sondern die nächste.

=Letzte Version der Quellen über einen anonymen GIT-Zugang abrufen=
Sie können diese Methode verwenden, wenn Sie keinen GIT-Zugang haben. Mit dieser Methode können Sie keine Änderungen einreichen. Wenn Sie also ein Entwickler sind, sollten Sie ein GitHub-Konto erstellen und die nächste Methode anstelle dieser Methode verwenden.

==Voraussetzungen==

*Mit Eclipse IDE

Zuerst müssen Sie eine funktionierende Installation von Eclipse haben. Das '''EGit'''-Plugin muss ebenfalls installiert worden sein.
Verwenden Sie dazu den '''Find And Install process''' im Eclipse Menü, fügen Sie die GIT update URL hinzu:
https://download.eclipse.org/egit/updates
Wählen Sie dann '''EGit''' zur Installation aus (JGit muss nicht ausgewählt werden)

*Mit der GIT-Kommandozeilen-Client-Schnittstelle

Sie müssen den GIT-Client installieren (das GIT-Befehlszeilentool wird unter Linux mit "sudo apt-get install git" installiert, für Windows ist der GIT-Client unter https://git-scm.com/download/win zu finden).

==Clone Prozess==
Geben Sie zunächst den Wert des Repositorys mit den Referenzquellen in Ihr GIT-Client-Tool ein.

*Mit Eclipse, gehen Sie in die Perspektive GIT, klicken Sie auf den Button "GIT Repository klonen". Geben Sie die GIT-URL des Projekts ein, das Sie erhalten möchten.
<source lang="ini">
git://github.com/Dolibarr/dolibarr.git (read only)
oder wenn Sie einen Fork von dolibarr github von der github-Weboberfläche erstellt haben
git@github.com:yourgitaccount/dolibarr.git (read and write access)
</source>
Ihr Eclipse-GIT-Client wird Sie auffordern, die Branches auszuwählen, an denen Sie interessiert sind. Branches, die jetzt noch nicht ausgewählt sind, können später durch einen "Fetch" aus der "Remotes"-Ansicht ausgewählt werden, aber versuchen Sie, nur den Branch auszuwählen, den Sie benötigen. Dies erspart Ihnen später Zeit und Probleme.

Hinweis: Wenn Sie sich hinter einer Firewall befinden, müssen Sie die Eclipse-Proxy-Zugangsdaten im Eclipse-Menü Fenster - Einstellungen - Allgemein - Netzwerkverbindung einstellen und die alternative URL verwenden:
<source lang="ini">
https://gitlogin:gitpassword@github.com/yourgitaccount/dolibarr.git
</source>

*Mit GIT auf der Befehlszeilenschnittstelle:

Richten Sie zunächst Ihren Git-Client ein:
<source lang="bash">
git config --global user.name "Your Name"
git config --global user.email "user@domain.com"
git config --list
</source>
Dann klonen Sie das Repository lokal:
<source lang="bash">
git://github.com/Dolibarr/dolibarr.git (nur lesen)
oder wenn Sie einen Fork von dolibarr github von der github-Weboberfläche erstellt haben
git@github.com:yourgitaccount/dolibarr.git (Lese- und Schreibzugriff)
</source>

Hinweis: Wenn Sie sich hinter einer Firewall befinden, müssen Sie Ihre Proxy-Informationen einstellen und die alternative https-URL verwenden:
<source lang="bash">
git config --global http.proxy http://proxyuser:proxypass@proxyserver:proxyport
git clone https://gitlogin:gitpassword@github.com/yourgitaccount/dolibarr.git dolibarr
</source>

Sobald dieser Schritt bestätigt ist, lädt Ihr GIT-Client alle Dateien vom entfernten GIT-Server herunter. Dies kann einige Sekunden oder Minuten dauern.

Sobald der Download abgeschlossen ist, müssen Sie wählen, an welchem Zweig Sie arbeiten möchten.

*Mit GIT auf der Befehlszeilenschnittstelle;

<source lang="bash">
git checkout develop
git checkout x.y
</source>
Dadurch wird eine lokale Branche erstellt und automatisch ein Checkout durchgeführt.

*Klicken Sie in Eclipse mit der rechten Maustaste auf "Branches - Remotes -" die Branche, die Sie lokal duplizieren möchten".
Wählen Sie " Erstelle Branch" (und markieren Sie das Kästchen "Checkout"). Dadurch wird der Inhalt der Branche dupliziert, um lokal daran zu arbeiten, und Ihr "Arbeitsverzeichnis" wird aktualisiert, um an dieser Branche zu arbeiten.

Erstellen Sie ein Eclipse-Projekt:

Wenn Sie Eclipse verwenden, erstellen Sie, sobald die Verzweigung lokal erstellt wurde, ein PHP-Projekt aus dem Assistenten, indem Sie "'''Create from existing project'''" wählen und das Verzeichnis auswählen, das Ihr lokales GIT-Repository ist (Wählen Sie nicht die Option, ein PHP-Projekt komplett neu zu erstellen).

Klicken Sie dann mit der rechten Maustaste auf das Projekt in Ihrem Eclipse-Arbeitsbereich und wählen Sie "'''Team - Share'''". Wählen Sie GIT und klicken Sie auf die Option "'''Use or create repository in parent folder of project'''".
Eine alternative Methode ist File->Import, Git->Project von Git, Wählen Sie das Git-Repository und Weiter, Assistent für neue Projekte verwenden -> Php-Projekt, geben Sie den Ordner Ihres lokalen GIT-Repositorys ein.

Dann können Sie Eclipse so einstellen, dass es nicht alle Projektdateien für seine Build-Tools (Outline Scanner, TODO Scanner, Syntax Scanner...) scannt. Dies verhindert, dass Eclipse zu langsam ist. Klicken Sie dazu mit der rechten Maustaste auf das Projekt, wählen Sie Build Path und stellen Sie es wie im folgenden Screenshot ein.

[[File:Eclipse php build path.png|240px]]

=Abrufen der letzten Version der Quellen über einen GitHub-Nutzerzugang=
==Voraussetzung==

*Mit Eclipse IDE

Sie müssen zuvor ein Konto auf GitHub (https://github.com/) erstellen und ein öffentliches RSA- oder DSA-Zertifikat in Ihr Kontoprofil hochladen.

Dann müssen Sie eine funktionierende Installation von Eclipse haben. Das '''EGit'''-Plugin muss ebenfalls installiert worden sein.
https://download.eclipse.org/egit/updates
Wählen Sie dann die Installation von '''EGit'''.
*Mit der GIT-Kommandozeilen-Schnittstelle:

Sie müssen zuvor ein Konto auf GitHub (https://github.com/) erstellen und ein öffentliches RSA- oder DSA-Zertifikat in Ihr Kontoprofil hochladen.

Dann müssen Sie den GIT-Client installieren (GIT-Kommandozeilen-Tool unter Linux mit "sudo apt-get install git" oder den GIT-Client für Windows unter https://git-scm.com/download/win).

==Fork Prozess==
Melden Sie sich bei Github mit den Login-Daten an, das Sie im vorherigen Schritt erstellt haben. Gehen Sie dann auf die Seite

https://github.com/Dolibarr/dolibarr

und klicken Sie auf die Schaltfläche "Fork".

Dadurch wird eine Kopie (ein Fork) des Projekts in Ihrem eigenen Github-Bereich erstellt. Da Sie der Besitzer dieses Forks sind, haben Sie alle Rechte, die Sie für die nächsten Schritte benötigen.

==Clone Prozess==
Dann ist der Prozess derselbe wie bei der Beschaffung von Quellen mit anonymen Zugriff.

Die für den GIT-Clone zu verwendende URL ist dieselbe:
<source lang="ini">
git@github.com:YourGitHubLogin/dolibarr.git
</source>

Beachten Sie, dass es auch eine HTTPS-URL gibt, die aber manchmal offline ist (verwenden Sie also lieber die erste, ein Link mit HTTPS ist nur erforderlich, wenn Sie sich hinter einer Firewall befinden):

<source lang="ini">
https://yourgithublogin@github.com/Dolibarr/dolibarr.git
</source>

=Update des Repository=
So aktualisieren Sie Ihren lokalen Workspace:

*Mit Eclipse IDE:

Rechtsklick auf das Eclipse-Projekt und Auswahl von "Pull".

Wenn Sie in Ihrem Eclipse-Workspace Änderungen an Dateien vorgenommen haben, die in der GIT-Remote-Referenz geändert wurden, wird Ihr GIT-Client automatisch einen Merge durchführen.

*Wenn es Konflikte gibt, wird der Merge alle Konfliktdateien als "Konflikt" markieren (siehe später, um diesen Zustand zu lösen).
*Wenn nicht, erhalten Sie alle Dateien in der neuen Version, einschließlich aller Ihrer Änderungen.

Wenn Sie bereits einige Dateien in Ihr lokales Repository übertragen haben, wird Ihr Workspace als "Zusammengeführt" markiert.
Alles was Sie tun müssen, ist ein Commit zu machen, um Ihr lokales Repository zu bestätigen, dass es sowohl Ihre Änderungen als auch die Änderungen anderer enthält.

*Mit dem GIT Command Line Client Interface:

<source lang="bash">
git pull
</source>

=Commit and publish your changes=
To see all changes you made into your working directory and waiting to be added into Git:

*With GIT Command Line Interface:

<source lang="bash">
git status
git diff subdir/filename
</source>

To add changes made into your local repository into the GIT index, then commit this index :

*With Eclipse: Right click on file or directory to commit. Select file to add/remove/update into commit.
*With GIT Command Line Interface:

<source lang="bash">
git commit -a -m "Commit text"
</source>
This will save add and changes into your local branch.

To push them on the GIT repository server,

*With Eclipse: right click on project and choose "'''Team - Push to Upstream'''".
*With GIT Command Line Interface:

<source lang="bash">
git push
</source>

To cancel a commit:

*With GIT Command Line Interface, if commit was not already pushed:

<source lang="bash">
git reset --soft HEAD~1
</source>

*With GIT Command Line Interface, if commit was already pushed:

<source lang="bash">
git revert IdCommit or git revert HEAD (for last commit)
</source>

To merge changes done into your forked GIT instance into official Dolibarr instance:

*Go into GitHub web interface of your forked Git instance.
*Click on small button "Create a Pull request".
*Choose commit you request inclusion and validate.

=Ask official project to include your changes=
Once you pushed one or several commit toward your distant fork area on github, you can ask the Dolibarr core team to include it into official project.
For this, follow this tutorial: https://help.github.com/articles/creating-a-pull-request/

=Add an external commit into current repository=
Some developers may work and do commit into their own Git repository after forking the project. If you are interesting into getting this changes, you can import them with the following steps.

You need both Eclipse and GIT Command Line interface to achieve this:

*First, go into GIT setup view and right click on "'''Remotes'''" of your Eclipse Git working space and choose "'''Create a remote...'''"
*Type name or remote fork the developer has create (in most cases, it's developer Git login). For example: "'''thedevlogin'''". Choose also "'''Configure Fetch'''".
*Type URI of Git repository of developer. For example: '''git://github.com/thedevlogin/dolibarr.git'''. Also add a refspec value to declare the branch you want to get. For example: '''refs/heads/master:refs/remotes/thedevlogin/master'''. Click "'''Save and Fetch'''". A new entry will be added into "Remote Tracking" making possible to read/get commits done into this branch.
Gehen Sie nun in die Kommandozeile Ihres Git-Repositorys (unter Linux ist es in den meisten Fällen '''/home/yourlogin/git/yourdolibarr''') und geben Sie den Befehl git cherry-pick ein:
<source lang="bash">
git cherry-pick -x commitid
</source>
wobei commitid der Wert der Commit-ID ist, die Sie erhalten möchten.

Sobald dies erledigt ist, gehen Sie zurück zu Eclipse und aktualisieren Sie das Projekt. Sie werden sehen, dass geänderte Dateien mit Dekoratoren erscheinen (mit Konflikten, wenn es welche gibt).

Wenn die Auswahl aufgrund von Konflikten fehlschlägt, können Sie den Versuch der Auswahl mit
<source lang="bash">
git cherry-pick --abort
</source>

=Einen Konflikt lösen=
Wenn eine Datei nach einem "Pull" als "Konflikt" markiert ist, öffnen Sie die Datei und bearbeiten Sie sie.
Rechercher la chaine "<<<<<<<<<<", vous verrez la partie de code en conflit entre "<<<<<<<<<" et ">>>>>>>>". Bearbeiten Sie die Codezeilen manuell, um das Endergebnis zu erhalten, indem Sie auch die "<<<<<<<<" et ">>>>>>>".

Klicken Sie dann mit der rechten Maustaste auf die Datei und wählen Sie " Hinzufügen".

Wenn Sie lieber alle Änderungen, die Sie an allen Dateien vorgenommen haben, vollständig rückgängig machen möchten (um Ihren Arbeitsbereich mit dem Inhalt des entfernten Repositoriums wiederherzustellen), können Sie einen Reset durchführen:

*Mit Eclipse klicken Sie mit der rechten Maustaste auf die oberste Zeile des Projekts und wählen Sie "Zurücksetzen" und dann "'''Hard'''" und dann "'''Reference - HEAD'''".
*Bei Verwendung des GIT-Befehlszeilentools erreichen Sie dies mit dem Befehl

<source lang="bash">
git reset --hard HEAD
</source>

=Taggen Sie die Quellen=
Mit den GIT-Kommandozeilenwerkzeugen:
Um ein Tag über eine Version zu erstellen:
<source lang="bash">
git tag -a -m "Release|Maintenance release x.y.z" "x.y.z"
oder
git tag -a -f -m "Beta x.y.betai" "x.y.betai_YYYYMMDD" idcommit # -f force wenn ein Tag bereits existiert, ermöglicht idcommit die Auswahl des zu taggenden Commits.
git push --tags # Pour pousser le tags sur le serveur distant
</source>

Um einen Tag zu löschen:
<source lang="bash">
git tag -d "x.y.z_YYYYMMDD"
git push origin :x.y.z_YYYYMMDD # Um die Löschung auf dem entfernten Server zu bestätigen
</source>

=Einen neue Branche erstellen=
Hier ist der Befehl, den Sie verwenden müssen, um einen neuen Zweig aus einem eigenen develop-Repository zu erstellen:
<source lang="bash">
git branch x.y
git push origin x.y
</source>

=Statistiken=
Mit den GIT-Kommandozeilenwerkzeugen:

Um die Anzahl der Änderungen zu zählen, die ein Entwickler zwischen Version x und y vorgenommen hat:

*Zuerst führen Sie "git merge-base" aus, um die ID des letzten gemeinsamen Commits zwischen x und y zu erfahren.

<source lang="bash">
git merge-base origin/3.1 origin/develop
</source>

*Dann führen Sie git log aus, um eine Liste aller Änderungen von der letzten gemeinsamen Übertragung bis zur letzten Übertragung zu erhalten.
<source lang="bash">
git log id_found_at_previous_step..HEAD
</source>

*Um die Gesamtzahl der hinzugefügten/gelöschten Zeilen zu ermitteln:
<source lang="bash">
git log --ancestry-path --numstat --pretty="%H" id_found_at_previous_step..HEAD | awk 'NF==3 {plus+=$1; minus+=$2} END {printf("+%d, -%d\n", plus, minus)}'
</source>

Zählen der endgültigen Änderungen zwischen einer Version x und y (dies unterscheidet sich von der vorherigen Zählung, da bei der vorherigen Zählung eine Änderung zweimal zu zwei verschiedenen Zeitpunkten durchgeführt werden kann, um unterschiedliche Änderungen vorzunehmen. Bei der zweiten Methode werden die Änderungen gezählt, die schließlich gefunden wurden, wenn die Änderungen beim ersten Versuch in Ordnung waren):

*Verwenden Sie die gleiche Methode wie zuvor, aber anstatt git log auszuführen, führen Sie '''git diff''' aus.

<source lang="bash">
git diff -b -M --numstat --pretty="%H" id_found_at_previous_step..HEAD | awk 'NF==3 {plus+=$1; minus+=$2} END {printf("+%d, -%d\n", plus, minus)}'
</source>

Weitere Informationen über die Verwendung von GIT erhältlich unter: [http://wiki.eclipse.org/EGit/User_Guide ici].

[[Category:Development]]

FAQ Get, update GIT Projekt Quellen

2022-09-24T07:16:22Z

Speaking services: /* Clone Prozess */

[[en:FAQ_Get,update_GIT_project_sources]]
[[fr:FAQ_Récupérer,_mettre_à_jour_les_sources_GIT_du_projet]]
[[es:FAQ_Recuperar,_actualizar_GIT_fuentes_del_proyecto]]


[[Category:FAQ DE]]
Hier finden Sie Informationen darüber, wie Sie die Quellen des Dolibarr-Projekts erhalten können.
Es werden mehrere Methoden beschrieben, aber wir empfehlen, die auf GitHub basierende Methode zu verwenden.

 

=Letzte Version der Quellen durch tgz-Download abrufen=
Diese Methode kann auch von nicht-technischen Benutzern verwendet werden.
Sie ermöglicht es Ihnen, die Quellen des Hauptentwicklungszweigs (HEAD genannt) zu erhalten, indem Sie einfach eine Datei herunterladen: Diese Operation besteht darin, die letzte Version der Dolibarr-Dateien zu erhalten, die jede Nacht in eine tgz-Datei gepackt werden. Die Datei ist über einen Link verfügbar:

{{LinkLastSnapshot}}

Neue Dateien überschreiben alte Dateien. Der Nachteil dieser Methode ist, dass Sie das Paket jedes Mal herunterladen und dekomprimieren müssen, wenn Sie Updates erhalten möchten.

Entwickler sollten diese Methode nicht verwenden, um Quellen zu erhalten, sondern die nächste.

=Letzte Version der Quellen über einen anonymen GIT-Zugang abrufen=
Sie können diese Methode verwenden, wenn Sie keinen GIT-Zugang haben. Mit dieser Methode können Sie keine Änderungen einreichen. Wenn Sie also ein Entwickler sind, sollten Sie ein GitHub-Konto erstellen und die nächste Methode anstelle dieser Methode verwenden.

==Voraussetzungen==

*Mit Eclipse IDE

Zuerst müssen Sie eine funktionierende Installation von Eclipse haben. Das '''EGit'''-Plugin muss ebenfalls installiert worden sein.
Verwenden Sie dazu den '''Find And Install process''' im Eclipse Menü, fügen Sie die GIT update URL hinzu:
https://download.eclipse.org/egit/updates
Wählen Sie dann '''EGit''' zur Installation aus (JGit muss nicht ausgewählt werden)

*Mit der GIT-Kommandozeilen-Client-Schnittstelle

Sie müssen den GIT-Client installieren (das GIT-Befehlszeilentool wird unter Linux mit "sudo apt-get install git" installiert, für Windows ist der GIT-Client unter https://git-scm.com/download/win zu finden).

==Clone Prozess==
Geben Sie zunächst den Wert des Repositorys mit den Referenzquellen in Ihr GIT-Client-Tool ein.

*Mit Eclipse, gehen Sie in die Perspektive GIT, klicken Sie auf den Button "GIT Repository klonen". Geben Sie die GIT-URL des Projekts ein, das Sie erhalten möchten.
<source lang="ini">
git://github.com/Dolibarr/dolibarr.git (read only)
oder wenn Sie einen Fork von dolibarr github von der github-Weboberfläche erstellt haben
git@github.com:yourgitaccount/dolibarr.git (read and write access)
</source>
Ihr Eclipse-GIT-Client wird Sie auffordern, die Branches auszuwählen, an denen Sie interessiert sind. Branches, die jetzt noch nicht ausgewählt sind, können später durch einen "Fetch" aus der "Remotes"-Ansicht ausgewählt werden, aber versuchen Sie, nur den Branch auszuwählen, den Sie benötigen. Dies erspart Ihnen später Zeit und Probleme.

Hinweis: Wenn Sie sich hinter einer Firewall befinden, müssen Sie die Eclipse-Proxy-Zugangsdaten im Eclipse-Menü Fenster - Einstellungen - Allgemein - Netzwerkverbindung einstellen und die alternative URL verwenden:
<source lang="ini">
https://gitlogin:gitpassword@github.com/yourgitaccount/dolibarr.git
</source>

*Mit GIT auf der Befehlszeilenschnittstelle:

Richten Sie zunächst Ihren Git-Client ein:
<source lang="bash">
git config --global user.name "Your Name"
git config --global user.email "user@domain.com"
git config --list
</source>
Dann klonen Sie das Repository lokal:
<source lang="bash">
git://github.com/Dolibarr/dolibarr.git (nur lesen)
oder wenn Sie einen Fork von dolibarr github von der github-Weboberfläche erstellt haben
git@github.com:yourgitaccount/dolibarr.git (Lese- und Schreibzugriff)
</source>

Hinweis: Wenn Sie sich hinter einer Firewall befinden, müssen Sie Ihre Proxy-Informationen einstellen und die alternative https-URL verwenden:
<source lang="bash">
git config --global http.proxy http://proxyuser:proxypass@proxyserver:proxyport
git clone https://gitlogin:gitpassword@github.com/yourgitaccount/dolibarr.git dolibarr
</source>

Sobald dieser Schritt bestätigt ist, lädt Ihr GIT-Client alle Dateien vom entfernten GIT-Server herunter. Dies kann einige Sekunden oder Minuten dauern.

Sobald der Download abgeschlossen ist, müssen Sie wählen, an welchem Zweig Sie arbeiten möchten.

*Mit GIT auf der Befehlszeilenschnittstelle;

<source lang="bash">
git checkout develop
git checkout x.y
</source>
Dadurch wird eine lokale Branche erstellt und automatisch ein Checkout durchgeführt.

*Klicken Sie in Eclipse mit der rechten Maustaste auf "Branches - Remotes -" die Branche, die Sie lokal duplizieren möchten".
Wählen Sie " Erstelle Branch" (und markieren Sie das Kästchen "Checkout"). Dadurch wird der Inhalt der Branche dupliziert, um lokal daran zu arbeiten, und Ihr "Arbeitsverzeichnis" wird aktualisiert, um an dieser Branche zu arbeiten.

Erstellen Sie ein Eclipse-Projekt:

Wenn Sie Eclipse verwenden, erstellen Sie, sobald die Verzweigung lokal erstellt wurde, ein PHP-Projekt aus dem Assistenten, indem Sie "'''Create from existing project'''" wählen und das Verzeichnis auswählen, das Ihr lokales GIT-Repository ist (Wählen Sie nicht die Option, ein PHP-Projekt komplett neu zu erstellen).

Klicken Sie dann mit der rechten Maustaste auf das Projekt in Ihrem Eclipse-Arbeitsbereich und wählen Sie "'''Team - Share'''". Wählen Sie GIT und klicken Sie auf die Option "'''Use or create repository in parent folder of project'''".
Eine alternative Methode ist File->Import, Git->Project von Git, Wählen Sie das Git-Repository und Weiter, Assistent für neue Projekte verwenden -> Php-Projekt, geben Sie den Ordner Ihres lokalen GIT-Repositorys ein.

Dann können Sie Eclipse so einstellen, dass es nicht alle Projektdateien für seine Build-Tools (Outline Scanner, TODO Scanner, Syntax Scanner...) scannt. Dies verhindert, dass Eclipse zu langsam ist. Klicken Sie dazu mit der rechten Maustaste auf das Projekt, wählen Sie Build Path und stellen Sie es wie im folgenden Screenshot ein.

[[File:Eclipse php build path.png|240px]]

=Abrufen der letzten Version der Quellen über einen GitHub-Nutzerzugang=
==Voraussetzung==

*Mit Eclipse IDE

Sie müssen zuvor ein Konto auf GitHub (https://github.com/) erstellen und ein öffentliches RSA- oder DSA-Zertifikat in Ihr Kontoprofil hochladen.

Dann müssen Sie eine funktionierende Installation von Eclipse haben. Das '''EGit'''-Plugin muss ebenfalls installiert worden sein.
https://download.eclipse.org/egit/updates
Wählen Sie dann die Installation von '''EGit'''.
*Mit der GIT-Kommandozeilen-Schnittstelle:

Sie müssen zuvor ein Konto auf GitHub (https://github.com/) erstellen und ein öffentliches RSA- oder DSA-Zertifikat in Ihr Kontoprofil hochladen.

Dann müssen Sie den GIT-Client installieren (GIT-Kommandozeilen-Tool unter Linux mit "sudo apt-get install git" oder den GIT-Client für Windows unter https://git-scm.com/download/win).

==Fork Prozess==
Melden Sie sich bei Github mit den Login-Daten an, das Sie im vorherigen Schritt erstellt haben. Gehen Sie dann auf die Seite

https://github.com/Dolibarr/dolibarr

und klicken Sie auf die Schaltfläche "Fork".

Dadurch wird eine Kopie (ein Fork) des Projekts in Ihrem eigenen Github-Bereich erstellt. Da Sie der Besitzer dieses Forks sind, haben Sie alle Rechte, die Sie für die nächsten Schritte benötigen.

==Clone Prozess==
Dann ist der Prozess derselbe wie bei der Beschaffung von Quellen mit anonymen Zugriff.

Die für den GIT-Clone zu verwendende URL ist dieselbe:
<source lang="ini">
git@github.com:YourGitHubLogin/dolibarr.git
</source>

Beachten Sie, dass es auch eine HTTPS-URL gibt, die aber manchmal offline ist (verwenden Sie also lieber die erste, ein Link mit HTTPS ist nur erforderlich, wenn Sie sich hinter einer Firewall befinden):

<source lang="ini">
https://yourgithublogin@github.com/Dolibarr/dolibarr.git
</source>

=Update your repository=
To update your local workspace:

*With Eclipse IDE:

right click on Eclipse project and select "Pull".

If you made some changes into your Eclipse workspace on files that were changed into the GIT remote reference, your GIT client will make a merge automatically.

*If there is conflicts, the merge will mark all conflict files as "conflict" (See later to solve this state).
*If not, you will get all new version files including all your changes.

If you already have commited some files into your local repository, your workspace will be marked as "Merged".
All you have to do is make a commit to validate your local repository as including your changes and changes made by others.

*With the GIT Command Line Client Interface:

<source lang="bash">
git pull
</source>

=Commit and publish your changes=
To see all changes you made into your working directory and waiting to be added into Git:

*With GIT Command Line Interface:

<source lang="bash">
git status
git diff subdir/filename
</source>

To add changes made into your local repository into the GIT index, then commit this index :

*With Eclipse: Right click on file or directory to commit. Select file to add/remove/update into commit.
*With GIT Command Line Interface:

<source lang="bash">
git commit -a -m "Commit text"
</source>
This will save add and changes into your local branch.

To push them on the GIT repository server,

*With Eclipse: right click on project and choose "'''Team - Push to Upstream'''".
*With GIT Command Line Interface:

<source lang="bash">
git push
</source>

To cancel a commit:

*With GIT Command Line Interface, if commit was not already pushed:

<source lang="bash">
git reset --soft HEAD~1
</source>

*With GIT Command Line Interface, if commit was already pushed:

<source lang="bash">
git revert IdCommit or git revert HEAD (for last commit)
</source>

To merge changes done into your forked GIT instance into official Dolibarr instance:

*Go into GitHub web interface of your forked Git instance.
*Click on small button "Create a Pull request".
*Choose commit you request inclusion and validate.

=Ask official project to include your changes=
Once you pushed one or several commit toward your distant fork area on github, you can ask the Dolibarr core team to include it into official project.
For this, follow this tutorial: https://help.github.com/articles/creating-a-pull-request/

=Add an external commit into current repository=
Some developers may work and do commit into their own Git repository after forking the project. If you are interesting into getting this changes, you can import them with the following steps.

You need both Eclipse and GIT Command Line interface to achieve this:

*First, go into GIT setup view and right click on "'''Remotes'''" of your Eclipse Git working space and choose "'''Create a remote...'''"
*Type name or remote fork the developer has create (in most cases, it's developer Git login). For example: "'''thedevlogin'''". Choose also "'''Configure Fetch'''".
*Type URI of Git repository of developer. For example: '''git://github.com/thedevlogin/dolibarr.git'''. Also add a refspec value to declare the branch you want to get. For example: '''refs/heads/master:refs/remotes/thedevlogin/master'''. Click "'''Save and Fetch'''". A new entry will be added into "Remote Tracking" making possible to read/get commits done into this branch.
Gehen Sie nun in die Kommandozeile Ihres Git-Repositorys (unter Linux ist es in den meisten Fällen '''/home/yourlogin/git/yourdolibarr''') und geben Sie den Befehl git cherry-pick ein:
<source lang="bash">
git cherry-pick -x commitid
</source>
wobei commitid der Wert der Commit-ID ist, die Sie erhalten möchten.

Sobald dies erledigt ist, gehen Sie zurück zu Eclipse und aktualisieren Sie das Projekt. Sie werden sehen, dass geänderte Dateien mit Dekoratoren erscheinen (mit Konflikten, wenn es welche gibt).

Wenn die Auswahl aufgrund von Konflikten fehlschlägt, können Sie den Versuch der Auswahl mit
<source lang="bash">
git cherry-pick --abort
</source>

=Einen Konflikt lösen=
Wenn eine Datei nach einem "Pull" als "Konflikt" markiert ist, öffnen Sie die Datei und bearbeiten Sie sie.
Rechercher la chaine "<<<<<<<<<<", vous verrez la partie de code en conflit entre "<<<<<<<<<" et ">>>>>>>>". Bearbeiten Sie die Codezeilen manuell, um das Endergebnis zu erhalten, indem Sie auch die "<<<<<<<<" et ">>>>>>>".

Klicken Sie dann mit der rechten Maustaste auf die Datei und wählen Sie " Hinzufügen".

Wenn Sie lieber alle Änderungen, die Sie an allen Dateien vorgenommen haben, vollständig rückgängig machen möchten (um Ihren Arbeitsbereich mit dem Inhalt des entfernten Repositoriums wiederherzustellen), können Sie einen Reset durchführen:

*Mit Eclipse klicken Sie mit der rechten Maustaste auf die oberste Zeile des Projekts und wählen Sie "Zurücksetzen" und dann "'''Hard'''" und dann "'''Reference - HEAD'''".
*Bei Verwendung des GIT-Befehlszeilentools erreichen Sie dies mit dem Befehl

<source lang="bash">
git reset --hard HEAD
</source>

=Taggen Sie die Quellen=
Mit den GIT-Kommandozeilenwerkzeugen:
Um ein Tag über eine Version zu erstellen:
<source lang="bash">
git tag -a -m "Release|Maintenance release x.y.z" "x.y.z"
oder
git tag -a -f -m "Beta x.y.betai" "x.y.betai_YYYYMMDD" idcommit # -f force wenn ein Tag bereits existiert, ermöglicht idcommit die Auswahl des zu taggenden Commits.
git push --tags # Pour pousser le tags sur le serveur distant
</source>

Um einen Tag zu löschen:
<source lang="bash">
git tag -d "x.y.z_YYYYMMDD"
git push origin :x.y.z_YYYYMMDD # Um die Löschung auf dem entfernten Server zu bestätigen
</source>

=Einen neue Branche erstellen=
Hier ist der Befehl, den Sie verwenden müssen, um einen neuen Zweig aus einem eigenen develop-Repository zu erstellen:
<source lang="bash">
git branch x.y
git push origin x.y
</source>

=Statistiken=
Mit den GIT-Kommandozeilenwerkzeugen:

Um die Anzahl der Änderungen zu zählen, die ein Entwickler zwischen Version x und y vorgenommen hat:

*Zuerst führen Sie "git merge-base" aus, um die ID des letzten gemeinsamen Commits zwischen x und y zu erfahren.

<source lang="bash">
git merge-base origin/3.1 origin/develop
</source>

*Dann führen Sie git log aus, um eine Liste aller Änderungen von der letzten gemeinsamen Übertragung bis zur letzten Übertragung zu erhalten.
<source lang="bash">
git log id_found_at_previous_step..HEAD
</source>

*Um die Gesamtzahl der hinzugefügten/gelöschten Zeilen zu ermitteln:
<source lang="bash">
git log --ancestry-path --numstat --pretty="%H" id_found_at_previous_step..HEAD | awk 'NF==3 {plus+=$1; minus+=$2} END {printf("+%d, -%d\n", plus, minus)}'
</source>

Zählen der endgültigen Änderungen zwischen einer Version x und y (dies unterscheidet sich von der vorherigen Zählung, da bei der vorherigen Zählung eine Änderung zweimal zu zwei verschiedenen Zeitpunkten durchgeführt werden kann, um unterschiedliche Änderungen vorzunehmen. Bei der zweiten Methode werden die Änderungen gezählt, die schließlich gefunden wurden, wenn die Änderungen beim ersten Versuch in Ordnung waren):

*Verwenden Sie die gleiche Methode wie zuvor, aber anstatt git log auszuführen, führen Sie '''git diff''' aus.

<source lang="bash">
git diff -b -M --numstat --pretty="%H" id_found_at_previous_step..HEAD | awk 'NF==3 {plus+=$1; minus+=$2} END {printf("+%d, -%d\n", plus, minus)}'
</source>

Weitere Informationen über die Verwendung von GIT erhältlich unter: [http://wiki.eclipse.org/EGit/User_Guide ici].

[[Category:Development]]

FAQ Get, update GIT Projekt Quellen

2022-09-24T07:15:44Z

Speaking services: /* Clone Prozess */

[[en:FAQ_Get,update_GIT_project_sources]]
[[fr:FAQ_Récupérer,_mettre_à_jour_les_sources_GIT_du_projet]]
[[es:FAQ_Recuperar,_actualizar_GIT_fuentes_del_proyecto]]


[[Category:FAQ DE]]
Hier finden Sie Informationen darüber, wie Sie die Quellen des Dolibarr-Projekts erhalten können.
Es werden mehrere Methoden beschrieben, aber wir empfehlen, die auf GitHub basierende Methode zu verwenden.

 

=Letzte Version der Quellen durch tgz-Download abrufen=
Diese Methode kann auch von nicht-technischen Benutzern verwendet werden.
Sie ermöglicht es Ihnen, die Quellen des Hauptentwicklungszweigs (HEAD genannt) zu erhalten, indem Sie einfach eine Datei herunterladen: Diese Operation besteht darin, die letzte Version der Dolibarr-Dateien zu erhalten, die jede Nacht in eine tgz-Datei gepackt werden. Die Datei ist über einen Link verfügbar:

{{LinkLastSnapshot}}

Neue Dateien überschreiben alte Dateien. Der Nachteil dieser Methode ist, dass Sie das Paket jedes Mal herunterladen und dekomprimieren müssen, wenn Sie Updates erhalten möchten.

Entwickler sollten diese Methode nicht verwenden, um Quellen zu erhalten, sondern die nächste.

=Letzte Version der Quellen über einen anonymen GIT-Zugang abrufen=
Sie können diese Methode verwenden, wenn Sie keinen GIT-Zugang haben. Mit dieser Methode können Sie keine Änderungen einreichen. Wenn Sie also ein Entwickler sind, sollten Sie ein GitHub-Konto erstellen und die nächste Methode anstelle dieser Methode verwenden.

==Voraussetzungen==

*Mit Eclipse IDE

Zuerst müssen Sie eine funktionierende Installation von Eclipse haben. Das '''EGit'''-Plugin muss ebenfalls installiert worden sein.
Verwenden Sie dazu den '''Find And Install process''' im Eclipse Menü, fügen Sie die GIT update URL hinzu:
https://download.eclipse.org/egit/updates
Wählen Sie dann '''EGit''' zur Installation aus (JGit muss nicht ausgewählt werden)

*Mit der GIT-Kommandozeilen-Client-Schnittstelle

Sie müssen den GIT-Client installieren (das GIT-Befehlszeilentool wird unter Linux mit "sudo apt-get install git" installiert, für Windows ist der GIT-Client unter https://git-scm.com/download/win zu finden).

==Clone Prozess==
Geben Sie zunächst den Wert des Repositorys mit den Referenzquellen in Ihr GIT-Client-Tool ein.

*Mit Eclipse, gehen Sie in die Perspektive GIT, klicken Sie auf den Button "GIT Repository klonen". Geben Sie die GIT-URL des Projekts ein, das Sie erhalten möchten.
<source lang="ini">
git://github.com/Dolibarr/dolibarr.git (read only)
oder wenn Sie einen Fork von dolibarr github von der github-Weboberfläche erstellt haben
git@github.com:yourgitaccount/dolibarr.git (read and write access)
</source>
Ihr Eclipse-GIT-Client wird Sie auffordern, die Branches auszuwählen, an denen Sie interessiert sind. Branches, die jetzt noch nicht ausgewählt sind, können später durch einen "Fetch" aus der "Remotes"-Ansicht ausgewählt werden, aber versuchen Sie, nur den Branch auszuwählen, den Sie benötigen. Dies erspart Ihnen später Zeit und Probleme.

Hinweis: Wenn Sie sich hinter einer Firewall befinden, müssen Sie die Eclipse-Proxy-Zugangsdaten im Eclipse-Menü Fenster - Einstellungen - Allgemein - Netzwerkverbindung einstellen und die alternative URL verwenden:
<source lang="ini">
https://gitlogin:gitpassword@github.com/yourgitaccount/dolibarr.git
</source>

*Mit GIT auf der Befehlszeilenschnittstelle:

Richten Sie zunächst Ihren Git-Client ein:
<source lang="bash">
git config --global user.name "Your Name"
git config --global user.email "user@domain.com"
git config --list
</source>
Dann klonen Sie das Repository lokal:
<source lang="bash">
git://github.com/Dolibarr/dolibarr.git (nur lesen)
oder wenn Sie einen Fork von dolibarr github von der github-Weboberfläche erstellt haben
git@github.com:yourgitaccount/dolibarr.git (Lese- und Schreibzugriff)
</source>

Hinweis: Wenn Sie sich hinter einer Firewall befinden, müssen Sie Ihre Proxy-Informationen einstellen und die alternative https-URL verwenden:
<source lang="bash">
git config --global http.proxy http://proxyuser:proxypass@proxyserver:proxyport
git clone https://gitlogin:gitpassword@github.com/yourgitaccount/dolibarr.git dolibarr
</source>

Sobald dieser Schritt bestätigt ist, lädt Ihr GIT-Client alle Dateien vom entfernten GIT-Server herunter. Dies kann einige Sekunden oder Minuten dauern.

Sobald der Download abgeschlossen ist, müssen Sie wählen, an welchem Zweig Sie arbeiten möchten.

*Mit GIT auf der Befehlszeilenschnittstelle;

<source lang="bash">
git checkout develop
git checkout x.y
</source>
Dadurch wird eine lokale Branche erstellt und automatisch ein Checkout durchgeführt.

*Klicken Sie in Eclipse mit der rechten Maustaste auf "Branches - Remotes -" die Branche, die Sie lokal duplizieren möchten".
Wählen Sie " Erstelle Branch" (und markieren Sie das Kästchen "Checkout"). Dadurch wird der Inhalt der Branche dupliziert, um lokal daran zu arbeiten, und Ihr "Arbeitsverzeichnis" wird aktualisiert, um an dieser Branche zu arbeiten.

Erstellen Sie ein Eclipse-Projekt:

Wenn Sie Eclipse verwenden, erstellen Sie, sobald die Verzweigung lokal erstellt wurde, ein PHP-Projekt aus dem Assistenten, indem Sie "'''Create from existing project'''" wählen und das Verzeichnis auswählen, das Ihr lokales GIT-Repository ist (Wählen Sie nicht die Option, ein PHP-Projekt komplett neu zu erstellen).

Klicken Sie dann mit der rechten Maustaste auf das Projekt in Ihrem Eclipse-Arbeitsbereich und wählen Sie "'''Team - Share'''". Wählen Sie GIT und klicken Sie auf die Option "'''Use or create repository in parent folder of project'''".
Eine alternative Methode ist File->Import, Git->Project von Git, Wählen Sie das Git-Repository und Weiter, Assistent für neue Projekte verwenden -> Php-Projekt, geben Sie den Ordner Ihres lokalen GIT-Repositorys ein.

Dann können Sie Eclipse so einstellen, dass es nicht alle Projektdateien für seine Build-Tools (Outline Scanner, TODO Scanner, Syntax Scanner...) scannt. Dies verhindert, dass Eclipse zu langsam ist. Klicken Sie dazu mit der rechten Maustaste auf das Projekt, wählen Sie Build Path und stellen Sie es wie im folgenden Screenshot ein.

[[File:Eclipse php build path.png|240px]]

=Abrufen der letzten Version der Quellen über einen GitHub-Nutzerzugang=
==Voraussetzung==

*Mit Eclipse IDE

Sie müssen zuvor ein Konto auf GitHub (https://github.com/) erstellen und ein öffentliches RSA- oder DSA-Zertifikat in Ihr Kontoprofil hochladen.

Dann müssen Sie eine funktionierende Installation von Eclipse haben. Das '''EGit'''-Plugin muss ebenfalls installiert worden sein.
https://download.eclipse.org/egit/updates
Wählen Sie dann die Installation von '''EGit'''.
*Mit der GIT-Kommandozeilen-Schnittstelle:

Sie müssen zuvor ein Konto auf GitHub (https://github.com/) erstellen und ein öffentliches RSA- oder DSA-Zertifikat in Ihr Kontoprofil hochladen.

Dann müssen Sie den GIT-Client installieren (GIT-Kommandozeilen-Tool unter Linux mit "sudo apt-get install git" oder den GIT-Client für Windows unter https://git-scm.com/download/win).

==Fork Prozess==
Melden Sie sich bei Github mit den Login-Daten an, das Sie im vorherigen Schritt erstellt haben. Gehen Sie dann auf die Seite

https://github.com/Dolibarr/dolibarr

und klicken Sie auf die Schaltfläche "Fork".

Dadurch wird eine Kopie (ein Fork) des Projekts in Ihrem eigenen Github-Bereich erstellt. Da Sie der Besitzer dieses Forks sind, haben Sie alle Rechte, die Sie für die nächsten Schritte benötigen.

==Clone Prozess==
Dann ist der Prozess derselbe wie bei der Beschaffung von Quellen mit anonymen Zugriff.

Die für den GIT-Clone zu verwendende URL ist dieselbe:
<source lang="ini">
git@github.com:YourGitHubLogin/dolibarr.git
</Quelle>

Beachten Sie, dass es auch eine HTTPS-URL gibt, die aber manchmal offline ist (verwenden Sie also lieber die erste, ein Link mit HTTPS ist nur erforderlich, wenn Sie sich hinter einer Firewall befinden):

<source lang="ini">
https://yourgithublogin@github.com/Dolibarr/dolibarr.git
</Quelle>

=Update your repository=
To update your local workspace:

*With Eclipse IDE:

right click on Eclipse project and select "Pull".

If you made some changes into your Eclipse workspace on files that were changed into the GIT remote reference, your GIT client will make a merge automatically.

*If there is conflicts, the merge will mark all conflict files as "conflict" (See later to solve this state).
*If not, you will get all new version files including all your changes.

If you already have commited some files into your local repository, your workspace will be marked as "Merged".
All you have to do is make a commit to validate your local repository as including your changes and changes made by others.

*With the GIT Command Line Client Interface:

<source lang="bash">
git pull
</source>

=Commit and publish your changes=
To see all changes you made into your working directory and waiting to be added into Git:

*With GIT Command Line Interface:

<source lang="bash">
git status
git diff subdir/filename
</source>

To add changes made into your local repository into the GIT index, then commit this index :

*With Eclipse: Right click on file or directory to commit. Select file to add/remove/update into commit.
*With GIT Command Line Interface:

<source lang="bash">
git commit -a -m "Commit text"
</source>
This will save add and changes into your local branch.

To push them on the GIT repository server,

*With Eclipse: right click on project and choose "'''Team - Push to Upstream'''".
*With GIT Command Line Interface:

<source lang="bash">
git push
</source>

To cancel a commit:

*With GIT Command Line Interface, if commit was not already pushed:

<source lang="bash">
git reset --soft HEAD~1
</source>

*With GIT Command Line Interface, if commit was already pushed:

<source lang="bash">
git revert IdCommit or git revert HEAD (for last commit)
</source>

To merge changes done into your forked GIT instance into official Dolibarr instance:

*Go into GitHub web interface of your forked Git instance.
*Click on small button "Create a Pull request".
*Choose commit you request inclusion and validate.

=Ask official project to include your changes=
Once you pushed one or several commit toward your distant fork area on github, you can ask the Dolibarr core team to include it into official project.
For this, follow this tutorial: https://help.github.com/articles/creating-a-pull-request/

=Add an external commit into current repository=
Some developers may work and do commit into their own Git repository after forking the project. If you are interesting into getting this changes, you can import them with the following steps.

You need both Eclipse and GIT Command Line interface to achieve this:

*First, go into GIT setup view and right click on "'''Remotes'''" of your Eclipse Git working space and choose "'''Create a remote...'''"
*Type name or remote fork the developer has create (in most cases, it's developer Git login). For example: "'''thedevlogin'''". Choose also "'''Configure Fetch'''".
*Type URI of Git repository of developer. For example: '''git://github.com/thedevlogin/dolibarr.git'''. Also add a refspec value to declare the branch you want to get. For example: '''refs/heads/master:refs/remotes/thedevlogin/master'''. Click "'''Save and Fetch'''". A new entry will be added into "Remote Tracking" making possible to read/get commits done into this branch.
Gehen Sie nun in die Kommandozeile Ihres Git-Repositorys (unter Linux ist es in den meisten Fällen '''/home/yourlogin/git/yourdolibarr''') und geben Sie den Befehl git cherry-pick ein:
<source lang="bash">
git cherry-pick -x commitid
</source>
wobei commitid der Wert der Commit-ID ist, die Sie erhalten möchten.

Sobald dies erledigt ist, gehen Sie zurück zu Eclipse und aktualisieren Sie das Projekt. Sie werden sehen, dass geänderte Dateien mit Dekoratoren erscheinen (mit Konflikten, wenn es welche gibt).

Wenn die Auswahl aufgrund von Konflikten fehlschlägt, können Sie den Versuch der Auswahl mit
<source lang="bash">
git cherry-pick --abort
</source>

=Einen Konflikt lösen=
Wenn eine Datei nach einem "Pull" als "Konflikt" markiert ist, öffnen Sie die Datei und bearbeiten Sie sie.
Rechercher la chaine "<<<<<<<<<<", vous verrez la partie de code en conflit entre "<<<<<<<<<" et ">>>>>>>>". Bearbeiten Sie die Codezeilen manuell, um das Endergebnis zu erhalten, indem Sie auch die "<<<<<<<<" et ">>>>>>>".

Klicken Sie dann mit der rechten Maustaste auf die Datei und wählen Sie " Hinzufügen".

Wenn Sie lieber alle Änderungen, die Sie an allen Dateien vorgenommen haben, vollständig rückgängig machen möchten (um Ihren Arbeitsbereich mit dem Inhalt des entfernten Repositoriums wiederherzustellen), können Sie einen Reset durchführen:

*Mit Eclipse klicken Sie mit der rechten Maustaste auf die oberste Zeile des Projekts und wählen Sie "Zurücksetzen" und dann "'''Hard'''" und dann "'''Reference - HEAD'''".
*Bei Verwendung des GIT-Befehlszeilentools erreichen Sie dies mit dem Befehl

<source lang="bash">
git reset --hard HEAD
</source>

=Taggen Sie die Quellen=
Mit den GIT-Kommandozeilenwerkzeugen:
Um ein Tag über eine Version zu erstellen:
<source lang="bash">
git tag -a -m "Release|Maintenance release x.y.z" "x.y.z"
oder
git tag -a -f -m "Beta x.y.betai" "x.y.betai_YYYYMMDD" idcommit # -f force wenn ein Tag bereits existiert, ermöglicht idcommit die Auswahl des zu taggenden Commits.
git push --tags # Pour pousser le tags sur le serveur distant
</source>

Um einen Tag zu löschen:
<source lang="bash">
git tag -d "x.y.z_YYYYMMDD"
git push origin :x.y.z_YYYYMMDD # Um die Löschung auf dem entfernten Server zu bestätigen
</source>

=Einen neue Branche erstellen=
Hier ist der Befehl, den Sie verwenden müssen, um einen neuen Zweig aus einem eigenen develop-Repository zu erstellen:
<source lang="bash">
git branch x.y
git push origin x.y
</source>

=Statistiken=
Mit den GIT-Kommandozeilenwerkzeugen:

Um die Anzahl der Änderungen zu zählen, die ein Entwickler zwischen Version x und y vorgenommen hat:

*Zuerst führen Sie "git merge-base" aus, um die ID des letzten gemeinsamen Commits zwischen x und y zu erfahren.

<source lang="bash">
git merge-base origin/3.1 origin/develop
</source>

*Dann führen Sie git log aus, um eine Liste aller Änderungen von der letzten gemeinsamen Übertragung bis zur letzten Übertragung zu erhalten.
<source lang="bash">
git log id_found_at_previous_step..HEAD
</source>

*Um die Gesamtzahl der hinzugefügten/gelöschten Zeilen zu ermitteln:
<source lang="bash">
git log --ancestry-path --numstat --pretty="%H" id_found_at_previous_step..HEAD | awk 'NF==3 {plus+=$1; minus+=$2} END {printf("+%d, -%d\n", plus, minus)}'
</source>

Zählen der endgültigen Änderungen zwischen einer Version x und y (dies unterscheidet sich von der vorherigen Zählung, da bei der vorherigen Zählung eine Änderung zweimal zu zwei verschiedenen Zeitpunkten durchgeführt werden kann, um unterschiedliche Änderungen vorzunehmen. Bei der zweiten Methode werden die Änderungen gezählt, die schließlich gefunden wurden, wenn die Änderungen beim ersten Versuch in Ordnung waren):

*Verwenden Sie die gleiche Methode wie zuvor, aber anstatt git log auszuführen, führen Sie '''git diff''' aus.

<source lang="bash">
git diff -b -M --numstat --pretty="%H" id_found_at_previous_step..HEAD | awk 'NF==3 {plus+=$1; minus+=$2} END {printf("+%d, -%d\n", plus, minus)}'
</source>

Weitere Informationen über die Verwendung von GIT erhältlich unter: [http://wiki.eclipse.org/EGit/User_Guide ici].

[[Category:Development]]

FAQ Get, update GIT Projekt Quellen

2022-09-24T07:14:46Z

Speaking services: /* Fork Prozess */

[[en:FAQ_Get,update_GIT_project_sources]]
[[fr:FAQ_Récupérer,_mettre_à_jour_les_sources_GIT_du_projet]]
[[es:FAQ_Recuperar,_actualizar_GIT_fuentes_del_proyecto]]


[[Category:FAQ DE]]
Hier finden Sie Informationen darüber, wie Sie die Quellen des Dolibarr-Projekts erhalten können.
Es werden mehrere Methoden beschrieben, aber wir empfehlen, die auf GitHub basierende Methode zu verwenden.

 

=Letzte Version der Quellen durch tgz-Download abrufen=
Diese Methode kann auch von nicht-technischen Benutzern verwendet werden.
Sie ermöglicht es Ihnen, die Quellen des Hauptentwicklungszweigs (HEAD genannt) zu erhalten, indem Sie einfach eine Datei herunterladen: Diese Operation besteht darin, die letzte Version der Dolibarr-Dateien zu erhalten, die jede Nacht in eine tgz-Datei gepackt werden. Die Datei ist über einen Link verfügbar:

{{LinkLastSnapshot}}

Neue Dateien überschreiben alte Dateien. Der Nachteil dieser Methode ist, dass Sie das Paket jedes Mal herunterladen und dekomprimieren müssen, wenn Sie Updates erhalten möchten.

Entwickler sollten diese Methode nicht verwenden, um Quellen zu erhalten, sondern die nächste.

=Letzte Version der Quellen über einen anonymen GIT-Zugang abrufen=
Sie können diese Methode verwenden, wenn Sie keinen GIT-Zugang haben. Mit dieser Methode können Sie keine Änderungen einreichen. Wenn Sie also ein Entwickler sind, sollten Sie ein GitHub-Konto erstellen und die nächste Methode anstelle dieser Methode verwenden.

==Voraussetzungen==

*Mit Eclipse IDE

Zuerst müssen Sie eine funktionierende Installation von Eclipse haben. Das '''EGit'''-Plugin muss ebenfalls installiert worden sein.
Verwenden Sie dazu den '''Find And Install process''' im Eclipse Menü, fügen Sie die GIT update URL hinzu:
https://download.eclipse.org/egit/updates
Wählen Sie dann '''EGit''' zur Installation aus (JGit muss nicht ausgewählt werden)

*Mit der GIT-Kommandozeilen-Client-Schnittstelle

Sie müssen den GIT-Client installieren (das GIT-Befehlszeilentool wird unter Linux mit "sudo apt-get install git" installiert, für Windows ist der GIT-Client unter https://git-scm.com/download/win zu finden).

==Clone Prozess==
Geben Sie zunächst den Wert des Repositorys mit den Referenzquellen in Ihr GIT-Client-Tool ein.

*Mit Eclipse, gehen Sie in die Perspektive GIT, klicken Sie auf den Button "GIT Repository klonen". Geben Sie die GIT-URL des Projekts ein, das Sie erhalten möchten.
<source lang="ini">
git://github.com/Dolibarr/dolibarr.git (read only)
oder wenn Sie einen Fork von dolibarr github von der github-Weboberfläche erstellt haben
git@github.com:yourgitaccount/dolibarr.git (read and write access)
</source>
Ihr Eclipse-GIT-Client wird Sie auffordern, die Branches auszuwählen, an denen Sie interessiert sind. Branches, die jetzt noch nicht ausgewählt sind, können später durch einen "Fetch" aus der "Remotes"-Ansicht ausgewählt werden, aber versuchen Sie, nur den Branch auszuwählen, den Sie benötigen. Dies erspart Ihnen später Zeit und Probleme.

Hinweis: Wenn Sie sich hinter einer Firewall befinden, müssen Sie die Eclipse-Proxy-Zugangsdaten im Eclipse-Menü Fenster - Einstellungen - Allgemein - Netzwerkverbindung einstellen und die alternative URL verwenden:
<source lang="ini">
https://gitlogin:gitpassword@github.com/yourgitaccount/dolibarr.git
</source>

*Mit GIT auf der Befehlszeilenschnittstelle:

Richten Sie zunächst Ihren Git-Client ein:
<source lang="bash">
git config --global user.name "Your Name"
git config --global user.email "user@domain.com"
git config --list
</source>
Dann klonen Sie das Repository lokal:
<source lang="bash">
git://github.com/Dolibarr/dolibarr.git (nur lesen)
oder wenn Sie einen Fork von dolibarr github von der github-Weboberfläche erstellt haben
git@github.com:yourgitaccount/dolibarr.git (Lese- und Schreibzugriff)
</source>

Hinweis: Wenn Sie sich hinter einer Firewall befinden, müssen Sie Ihre Proxy-Informationen einstellen und die alternative https-URL verwenden:
<source lang="bash">
git config --global http.proxy http://proxyuser:proxypass@proxyserver:proxyport
git clone https://gitlogin:gitpassword@github.com/yourgitaccount/dolibarr.git dolibarr
</source>

Sobald dieser Schritt bestätigt ist, lädt Ihr GIT-Client alle Dateien vom entfernten GIT-Server herunter. Dies kann einige Sekunden oder Minuten dauern.

Sobald der Download abgeschlossen ist, müssen Sie wählen, an welchem Zweig Sie arbeiten möchten.

*Mit GIT auf der Befehlszeilenschnittstelle;

<source lang="bash">
git checkout develop
git checkout x.y
</source>
Dadurch wird eine lokale Branche erstellt und automatisch ein Checkout durchgeführt.

*Klicken Sie in Eclipse mit der rechten Maustaste auf "Branches - Remotes -" die Branche, die Sie lokal duplizieren möchten".
Wählen Sie " Erstelle Branch" (und markieren Sie das Kästchen "Checkout"). Dadurch wird der Inhalt der Branche dupliziert, um lokal daran zu arbeiten, und Ihr "Arbeitsverzeichnis" wird aktualisiert, um an dieser Branche zu arbeiten.

Erstellen Sie ein Eclipse-Projekt:

Wenn Sie Eclipse verwenden, erstellen Sie, sobald die Verzweigung lokal erstellt wurde, ein PHP-Projekt aus dem Assistenten, indem Sie "'''Create from existing project'''" wählen und das Verzeichnis auswählen, das Ihr lokales GIT-Repository ist (Wählen Sie nicht die Option, ein PHP-Projekt komplett neu zu erstellen).

Klicken Sie dann mit der rechten Maustaste auf das Projekt in Ihrem Eclipse-Arbeitsbereich und wählen Sie "'''Team - Share'''". Wählen Sie GIT und klicken Sie auf die Option "'''Use or create repository in parent folder of project'''".
Eine alternative Methode ist File->Import, Git->Project von Git, Wählen Sie das Git-Repository und Weiter, Assistent für neue Projekte verwenden -> Php-Projekt, geben Sie den Ordner Ihres lokalen GIT-Repositorys ein.

Dann können Sie Eclipse so einstellen, dass es nicht alle Projektdateien für seine Build-Tools (Outline Scanner, TODO Scanner, Syntax Scanner...) scannt. Dies verhindert, dass Eclipse zu langsam ist. Klicken Sie dazu mit der rechten Maustaste auf das Projekt, wählen Sie Build Path und stellen Sie es wie im folgenden Screenshot ein.

[[File:Eclipse php build path.png|240px]]

=Abrufen der letzten Version der Quellen über einen GitHub-Nutzerzugang=
==Voraussetzung==

*Mit Eclipse IDE

Sie müssen zuvor ein Konto auf GitHub (https://github.com/) erstellen und ein öffentliches RSA- oder DSA-Zertifikat in Ihr Kontoprofil hochladen.

Dann müssen Sie eine funktionierende Installation von Eclipse haben. Das '''EGit'''-Plugin muss ebenfalls installiert worden sein.
https://download.eclipse.org/egit/updates
Wählen Sie dann die Installation von '''EGit'''.
*Mit der GIT-Kommandozeilen-Schnittstelle:

Sie müssen zuvor ein Konto auf GitHub (https://github.com/) erstellen und ein öffentliches RSA- oder DSA-Zertifikat in Ihr Kontoprofil hochladen.

Dann müssen Sie den GIT-Client installieren (GIT-Kommandozeilen-Tool unter Linux mit "sudo apt-get install git" oder den GIT-Client für Windows unter https://git-scm.com/download/win).

==Fork Prozess==
Melden Sie sich bei Github mit den Login-Daten an, das Sie im vorherigen Schritt erstellt haben. Gehen Sie dann auf die Seite

https://github.com/Dolibarr/dolibarr

und klicken Sie auf die Schaltfläche "Fork".

Dadurch wird eine Kopie (ein Fork) des Projekts in Ihrem eigenen Github-Bereich erstellt. Da Sie der Besitzer dieses Forks sind, haben Sie alle Rechte, die Sie für die nächsten Schritte benötigen.

==Clone Prozess==
Then process is same as getting sources with anonymous access.

URL to use for GIT clone is same:
<source lang="ini">
git@github.com:YourGitHubLogin/dolibarr.git
</source>

Note that a HTTPS URL is also available but it's sometimes offline (so prefer using first one, link with HTTPS is required only if you are behind a firewall):

<source lang="ini">
https://yourgithublogin@github.com/Dolibarr/dolibarr.git
</source>

=Update your repository=
To update your local workspace:

*With Eclipse IDE:

right click on Eclipse project and select "Pull".

If you made some changes into your Eclipse workspace on files that were changed into the GIT remote reference, your GIT client will make a merge automatically.

*If there is conflicts, the merge will mark all conflict files as "conflict" (See later to solve this state).
*If not, you will get all new version files including all your changes.

If you already have commited some files into your local repository, your workspace will be marked as "Merged".
All you have to do is make a commit to validate your local repository as including your changes and changes made by others.

*With the GIT Command Line Client Interface:

<source lang="bash">
git pull
</source>

=Commit and publish your changes=
To see all changes you made into your working directory and waiting to be added into Git:

*With GIT Command Line Interface:

<source lang="bash">
git status
git diff subdir/filename
</source>

To add changes made into your local repository into the GIT index, then commit this index :

*With Eclipse: Right click on file or directory to commit. Select file to add/remove/update into commit.
*With GIT Command Line Interface:

<source lang="bash">
git commit -a -m "Commit text"
</source>
This will save add and changes into your local branch.

To push them on the GIT repository server,

*With Eclipse: right click on project and choose "'''Team - Push to Upstream'''".
*With GIT Command Line Interface:

<source lang="bash">
git push
</source>

To cancel a commit:

*With GIT Command Line Interface, if commit was not already pushed:

<source lang="bash">
git reset --soft HEAD~1
</source>

*With GIT Command Line Interface, if commit was already pushed:

<source lang="bash">
git revert IdCommit or git revert HEAD (for last commit)
</source>

To merge changes done into your forked GIT instance into official Dolibarr instance:

*Go into GitHub web interface of your forked Git instance.
*Click on small button "Create a Pull request".
*Choose commit you request inclusion and validate.

=Ask official project to include your changes=
Once you pushed one or several commit toward your distant fork area on github, you can ask the Dolibarr core team to include it into official project.
For this, follow this tutorial: https://help.github.com/articles/creating-a-pull-request/

=Add an external commit into current repository=
Some developers may work and do commit into their own Git repository after forking the project. If you are interesting into getting this changes, you can import them with the following steps.

You need both Eclipse and GIT Command Line interface to achieve this:

*First, go into GIT setup view and right click on "'''Remotes'''" of your Eclipse Git working space and choose "'''Create a remote...'''"
*Type name or remote fork the developer has create (in most cases, it's developer Git login). For example: "'''thedevlogin'''". Choose also "'''Configure Fetch'''".
*Type URI of Git repository of developer. For example: '''git://github.com/thedevlogin/dolibarr.git'''. Also add a refspec value to declare the branch you want to get. For example: '''refs/heads/master:refs/remotes/thedevlogin/master'''. Click "'''Save and Fetch'''". A new entry will be added into "Remote Tracking" making possible to read/get commits done into this branch.
Gehen Sie nun in die Kommandozeile Ihres Git-Repositorys (unter Linux ist es in den meisten Fällen '''/home/yourlogin/git/yourdolibarr''') und geben Sie den Befehl git cherry-pick ein:
<source lang="bash">
git cherry-pick -x commitid
</source>
wobei commitid der Wert der Commit-ID ist, die Sie erhalten möchten.

Sobald dies erledigt ist, gehen Sie zurück zu Eclipse und aktualisieren Sie das Projekt. Sie werden sehen, dass geänderte Dateien mit Dekoratoren erscheinen (mit Konflikten, wenn es welche gibt).

Wenn die Auswahl aufgrund von Konflikten fehlschlägt, können Sie den Versuch der Auswahl mit
<source lang="bash">
git cherry-pick --abort
</source>

=Einen Konflikt lösen=
Wenn eine Datei nach einem "Pull" als "Konflikt" markiert ist, öffnen Sie die Datei und bearbeiten Sie sie.
Rechercher la chaine "<<<<<<<<<<", vous verrez la partie de code en conflit entre "<<<<<<<<<" et ">>>>>>>>". Bearbeiten Sie die Codezeilen manuell, um das Endergebnis zu erhalten, indem Sie auch die "<<<<<<<<" et ">>>>>>>".

Klicken Sie dann mit der rechten Maustaste auf die Datei und wählen Sie " Hinzufügen".

Wenn Sie lieber alle Änderungen, die Sie an allen Dateien vorgenommen haben, vollständig rückgängig machen möchten (um Ihren Arbeitsbereich mit dem Inhalt des entfernten Repositoriums wiederherzustellen), können Sie einen Reset durchführen:

*Mit Eclipse klicken Sie mit der rechten Maustaste auf die oberste Zeile des Projekts und wählen Sie "Zurücksetzen" und dann "'''Hard'''" und dann "'''Reference - HEAD'''".
*Bei Verwendung des GIT-Befehlszeilentools erreichen Sie dies mit dem Befehl

<source lang="bash">
git reset --hard HEAD
</source>

=Taggen Sie die Quellen=
Mit den GIT-Kommandozeilenwerkzeugen:
Um ein Tag über eine Version zu erstellen:
<source lang="bash">
git tag -a -m "Release|Maintenance release x.y.z" "x.y.z"
oder
git tag -a -f -m "Beta x.y.betai" "x.y.betai_YYYYMMDD" idcommit # -f force wenn ein Tag bereits existiert, ermöglicht idcommit die Auswahl des zu taggenden Commits.
git push --tags # Pour pousser le tags sur le serveur distant
</source>

Um einen Tag zu löschen:
<source lang="bash">
git tag -d "x.y.z_YYYYMMDD"
git push origin :x.y.z_YYYYMMDD # Um die Löschung auf dem entfernten Server zu bestätigen
</source>

=Einen neue Branche erstellen=
Hier ist der Befehl, den Sie verwenden müssen, um einen neuen Zweig aus einem eigenen develop-Repository zu erstellen:
<source lang="bash">
git branch x.y
git push origin x.y
</source>

=Statistiken=
Mit den GIT-Kommandozeilenwerkzeugen:

Um die Anzahl der Änderungen zu zählen, die ein Entwickler zwischen Version x und y vorgenommen hat:

*Zuerst führen Sie "git merge-base" aus, um die ID des letzten gemeinsamen Commits zwischen x und y zu erfahren.

<source lang="bash">
git merge-base origin/3.1 origin/develop
</source>

*Dann führen Sie git log aus, um eine Liste aller Änderungen von der letzten gemeinsamen Übertragung bis zur letzten Übertragung zu erhalten.
<source lang="bash">
git log id_found_at_previous_step..HEAD
</source>

*Um die Gesamtzahl der hinzugefügten/gelöschten Zeilen zu ermitteln:
<source lang="bash">
git log --ancestry-path --numstat --pretty="%H" id_found_at_previous_step..HEAD | awk 'NF==3 {plus+=$1; minus+=$2} END {printf("+%d, -%d\n", plus, minus)}'
</source>

Zählen der endgültigen Änderungen zwischen einer Version x und y (dies unterscheidet sich von der vorherigen Zählung, da bei der vorherigen Zählung eine Änderung zweimal zu zwei verschiedenen Zeitpunkten durchgeführt werden kann, um unterschiedliche Änderungen vorzunehmen. Bei der zweiten Methode werden die Änderungen gezählt, die schließlich gefunden wurden, wenn die Änderungen beim ersten Versuch in Ordnung waren):

*Verwenden Sie die gleiche Methode wie zuvor, aber anstatt git log auszuführen, führen Sie '''git diff''' aus.

<source lang="bash">
git diff -b -M --numstat --pretty="%H" id_found_at_previous_step..HEAD | awk 'NF==3 {plus+=$1; minus+=$2} END {printf("+%d, -%d\n", plus, minus)}'
</source>

Weitere Informationen über die Verwendung von GIT erhältlich unter: [http://wiki.eclipse.org/EGit/User_Guide ici].

[[Category:Development]]

FAQ Get, update GIT Projekt Quellen

2022-09-24T07:13:21Z

Speaking services: /* Voraussetzung */

[[en:FAQ_Get,update_GIT_project_sources]]
[[fr:FAQ_Récupérer,_mettre_à_jour_les_sources_GIT_du_projet]]
[[es:FAQ_Recuperar,_actualizar_GIT_fuentes_del_proyecto]]


[[Category:FAQ DE]]
Hier finden Sie Informationen darüber, wie Sie die Quellen des Dolibarr-Projekts erhalten können.
Es werden mehrere Methoden beschrieben, aber wir empfehlen, die auf GitHub basierende Methode zu verwenden.

 

=Letzte Version der Quellen durch tgz-Download abrufen=
Diese Methode kann auch von nicht-technischen Benutzern verwendet werden.
Sie ermöglicht es Ihnen, die Quellen des Hauptentwicklungszweigs (HEAD genannt) zu erhalten, indem Sie einfach eine Datei herunterladen: Diese Operation besteht darin, die letzte Version der Dolibarr-Dateien zu erhalten, die jede Nacht in eine tgz-Datei gepackt werden. Die Datei ist über einen Link verfügbar:

{{LinkLastSnapshot}}

Neue Dateien überschreiben alte Dateien. Der Nachteil dieser Methode ist, dass Sie das Paket jedes Mal herunterladen und dekomprimieren müssen, wenn Sie Updates erhalten möchten.

Entwickler sollten diese Methode nicht verwenden, um Quellen zu erhalten, sondern die nächste.

=Letzte Version der Quellen über einen anonymen GIT-Zugang abrufen=
Sie können diese Methode verwenden, wenn Sie keinen GIT-Zugang haben. Mit dieser Methode können Sie keine Änderungen einreichen. Wenn Sie also ein Entwickler sind, sollten Sie ein GitHub-Konto erstellen und die nächste Methode anstelle dieser Methode verwenden.

==Voraussetzungen==

*Mit Eclipse IDE

Zuerst müssen Sie eine funktionierende Installation von Eclipse haben. Das '''EGit'''-Plugin muss ebenfalls installiert worden sein.
Verwenden Sie dazu den '''Find And Install process''' im Eclipse Menü, fügen Sie die GIT update URL hinzu:
https://download.eclipse.org/egit/updates
Wählen Sie dann '''EGit''' zur Installation aus (JGit muss nicht ausgewählt werden)

*Mit der GIT-Kommandozeilen-Client-Schnittstelle

Sie müssen den GIT-Client installieren (das GIT-Befehlszeilentool wird unter Linux mit "sudo apt-get install git" installiert, für Windows ist der GIT-Client unter https://git-scm.com/download/win zu finden).

==Clone Prozess==
Geben Sie zunächst den Wert des Repositorys mit den Referenzquellen in Ihr GIT-Client-Tool ein.

*Mit Eclipse, gehen Sie in die Perspektive GIT, klicken Sie auf den Button "GIT Repository klonen". Geben Sie die GIT-URL des Projekts ein, das Sie erhalten möchten.
<source lang="ini">
git://github.com/Dolibarr/dolibarr.git (read only)
oder wenn Sie einen Fork von dolibarr github von der github-Weboberfläche erstellt haben
git@github.com:yourgitaccount/dolibarr.git (read and write access)
</source>
Ihr Eclipse-GIT-Client wird Sie auffordern, die Branches auszuwählen, an denen Sie interessiert sind. Branches, die jetzt noch nicht ausgewählt sind, können später durch einen "Fetch" aus der "Remotes"-Ansicht ausgewählt werden, aber versuchen Sie, nur den Branch auszuwählen, den Sie benötigen. Dies erspart Ihnen später Zeit und Probleme.

Hinweis: Wenn Sie sich hinter einer Firewall befinden, müssen Sie die Eclipse-Proxy-Zugangsdaten im Eclipse-Menü Fenster - Einstellungen - Allgemein - Netzwerkverbindung einstellen und die alternative URL verwenden:
<source lang="ini">
https://gitlogin:gitpassword@github.com/yourgitaccount/dolibarr.git
</source>

*Mit GIT auf der Befehlszeilenschnittstelle:

Richten Sie zunächst Ihren Git-Client ein:
<source lang="bash">
git config --global user.name "Your Name"
git config --global user.email "user@domain.com"
git config --list
</source>
Dann klonen Sie das Repository lokal:
<source lang="bash">
git://github.com/Dolibarr/dolibarr.git (nur lesen)
oder wenn Sie einen Fork von dolibarr github von der github-Weboberfläche erstellt haben
git@github.com:yourgitaccount/dolibarr.git (Lese- und Schreibzugriff)
</source>

Hinweis: Wenn Sie sich hinter einer Firewall befinden, müssen Sie Ihre Proxy-Informationen einstellen und die alternative https-URL verwenden:
<source lang="bash">
git config --global http.proxy http://proxyuser:proxypass@proxyserver:proxyport
git clone https://gitlogin:gitpassword@github.com/yourgitaccount/dolibarr.git dolibarr
</source>

Sobald dieser Schritt bestätigt ist, lädt Ihr GIT-Client alle Dateien vom entfernten GIT-Server herunter. Dies kann einige Sekunden oder Minuten dauern.

Sobald der Download abgeschlossen ist, müssen Sie wählen, an welchem Zweig Sie arbeiten möchten.

*Mit GIT auf der Befehlszeilenschnittstelle;

<source lang="bash">
git checkout develop
git checkout x.y
</source>
Dadurch wird eine lokale Branche erstellt und automatisch ein Checkout durchgeführt.

*Klicken Sie in Eclipse mit der rechten Maustaste auf "Branches - Remotes -" die Branche, die Sie lokal duplizieren möchten".
Wählen Sie " Erstelle Branch" (und markieren Sie das Kästchen "Checkout"). Dadurch wird der Inhalt der Branche dupliziert, um lokal daran zu arbeiten, und Ihr "Arbeitsverzeichnis" wird aktualisiert, um an dieser Branche zu arbeiten.

Erstellen Sie ein Eclipse-Projekt:

Wenn Sie Eclipse verwenden, erstellen Sie, sobald die Verzweigung lokal erstellt wurde, ein PHP-Projekt aus dem Assistenten, indem Sie "'''Create from existing project'''" wählen und das Verzeichnis auswählen, das Ihr lokales GIT-Repository ist (Wählen Sie nicht die Option, ein PHP-Projekt komplett neu zu erstellen).

Klicken Sie dann mit der rechten Maustaste auf das Projekt in Ihrem Eclipse-Arbeitsbereich und wählen Sie "'''Team - Share'''". Wählen Sie GIT und klicken Sie auf die Option "'''Use or create repository in parent folder of project'''".
Eine alternative Methode ist File->Import, Git->Project von Git, Wählen Sie das Git-Repository und Weiter, Assistent für neue Projekte verwenden -> Php-Projekt, geben Sie den Ordner Ihres lokalen GIT-Repositorys ein.

Dann können Sie Eclipse so einstellen, dass es nicht alle Projektdateien für seine Build-Tools (Outline Scanner, TODO Scanner, Syntax Scanner...) scannt. Dies verhindert, dass Eclipse zu langsam ist. Klicken Sie dazu mit der rechten Maustaste auf das Projekt, wählen Sie Build Path und stellen Sie es wie im folgenden Screenshot ein.

[[File:Eclipse php build path.png|240px]]

=Abrufen der letzten Version der Quellen über einen GitHub-Nutzerzugang=
==Voraussetzung==

*Mit Eclipse IDE

Sie müssen zuvor ein Konto auf GitHub (https://github.com/) erstellen und ein öffentliches RSA- oder DSA-Zertifikat in Ihr Kontoprofil hochladen.

Dann müssen Sie eine funktionierende Installation von Eclipse haben. Das '''EGit'''-Plugin muss ebenfalls installiert worden sein.
https://download.eclipse.org/egit/updates
Wählen Sie dann die Installation von '''EGit'''.
*Mit der GIT-Kommandozeilen-Schnittstelle:

Sie müssen zuvor ein Konto auf GitHub (https://github.com/) erstellen und ein öffentliches RSA- oder DSA-Zertifikat in Ihr Kontoprofil hochladen.

Dann müssen Sie den GIT-Client installieren (GIT-Kommandozeilen-Tool unter Linux mit "sudo apt-get install git" oder den GIT-Client für Windows unter https://git-scm.com/download/win).

==Fork Prozess==
Login to Github, with login you created in previous step. Then go onto page

https://github.com/Dolibarr/dolibarr

And click on button "Fork".

This will create a copy (a fork) of project into your own github area. Because you will be the owner of this fork, you will have all permissions on it to be used in next steps.

==Clone Prozess==
Then process is same as getting sources with anonymous access.

URL to use for GIT clone is same:
<source lang="ini">
git@github.com:YourGitHubLogin/dolibarr.git
</source>

Note that a HTTPS URL is also available but it's sometimes offline (so prefer using first one, link with HTTPS is required only if you are behind a firewall):

<source lang="ini">
https://yourgithublogin@github.com/Dolibarr/dolibarr.git
</source>

=Update your repository=
To update your local workspace:

*With Eclipse IDE:

right click on Eclipse project and select "Pull".

If you made some changes into your Eclipse workspace on files that were changed into the GIT remote reference, your GIT client will make a merge automatically.

*If there is conflicts, the merge will mark all conflict files as "conflict" (See later to solve this state).
*If not, you will get all new version files including all your changes.

If you already have commited some files into your local repository, your workspace will be marked as "Merged".
All you have to do is make a commit to validate your local repository as including your changes and changes made by others.

*With the GIT Command Line Client Interface:

<source lang="bash">
git pull
</source>

=Commit and publish your changes=
To see all changes you made into your working directory and waiting to be added into Git:

*With GIT Command Line Interface:

<source lang="bash">
git status
git diff subdir/filename
</source>

To add changes made into your local repository into the GIT index, then commit this index :

*With Eclipse: Right click on file or directory to commit. Select file to add/remove/update into commit.
*With GIT Command Line Interface:

<source lang="bash">
git commit -a -m "Commit text"
</source>
This will save add and changes into your local branch.

To push them on the GIT repository server,

*With Eclipse: right click on project and choose "'''Team - Push to Upstream'''".
*With GIT Command Line Interface:

<source lang="bash">
git push
</source>

To cancel a commit:

*With GIT Command Line Interface, if commit was not already pushed:

<source lang="bash">
git reset --soft HEAD~1
</source>

*With GIT Command Line Interface, if commit was already pushed:

<source lang="bash">
git revert IdCommit or git revert HEAD (for last commit)
</source>

To merge changes done into your forked GIT instance into official Dolibarr instance:

*Go into GitHub web interface of your forked Git instance.
*Click on small button "Create a Pull request".
*Choose commit you request inclusion and validate.

=Ask official project to include your changes=
Once you pushed one or several commit toward your distant fork area on github, you can ask the Dolibarr core team to include it into official project.
For this, follow this tutorial: https://help.github.com/articles/creating-a-pull-request/

=Add an external commit into current repository=
Some developers may work and do commit into their own Git repository after forking the project. If you are interesting into getting this changes, you can import them with the following steps.

You need both Eclipse and GIT Command Line interface to achieve this:

*First, go into GIT setup view and right click on "'''Remotes'''" of your Eclipse Git working space and choose "'''Create a remote...'''"
*Type name or remote fork the developer has create (in most cases, it's developer Git login). For example: "'''thedevlogin'''". Choose also "'''Configure Fetch'''".
*Type URI of Git repository of developer. For example: '''git://github.com/thedevlogin/dolibarr.git'''. Also add a refspec value to declare the branch you want to get. For example: '''refs/heads/master:refs/remotes/thedevlogin/master'''. Click "'''Save and Fetch'''". A new entry will be added into "Remote Tracking" making possible to read/get commits done into this branch.
Gehen Sie nun in die Kommandozeile Ihres Git-Repositorys (unter Linux ist es in den meisten Fällen '''/home/yourlogin/git/yourdolibarr''') und geben Sie den Befehl git cherry-pick ein:
<source lang="bash">
git cherry-pick -x commitid
</source>
wobei commitid der Wert der Commit-ID ist, die Sie erhalten möchten.

Sobald dies erledigt ist, gehen Sie zurück zu Eclipse und aktualisieren Sie das Projekt. Sie werden sehen, dass geänderte Dateien mit Dekoratoren erscheinen (mit Konflikten, wenn es welche gibt).

Wenn die Auswahl aufgrund von Konflikten fehlschlägt, können Sie den Versuch der Auswahl mit
<source lang="bash">
git cherry-pick --abort
</source>

=Einen Konflikt lösen=
Wenn eine Datei nach einem "Pull" als "Konflikt" markiert ist, öffnen Sie die Datei und bearbeiten Sie sie.
Rechercher la chaine "<<<<<<<<<<", vous verrez la partie de code en conflit entre "<<<<<<<<<" et ">>>>>>>>". Bearbeiten Sie die Codezeilen manuell, um das Endergebnis zu erhalten, indem Sie auch die "<<<<<<<<" et ">>>>>>>".

Klicken Sie dann mit der rechten Maustaste auf die Datei und wählen Sie " Hinzufügen".

Wenn Sie lieber alle Änderungen, die Sie an allen Dateien vorgenommen haben, vollständig rückgängig machen möchten (um Ihren Arbeitsbereich mit dem Inhalt des entfernten Repositoriums wiederherzustellen), können Sie einen Reset durchführen:

*Mit Eclipse klicken Sie mit der rechten Maustaste auf die oberste Zeile des Projekts und wählen Sie "Zurücksetzen" und dann "'''Hard'''" und dann "'''Reference - HEAD'''".
*Bei Verwendung des GIT-Befehlszeilentools erreichen Sie dies mit dem Befehl

<source lang="bash">
git reset --hard HEAD
</source>

=Taggen Sie die Quellen=
Mit den GIT-Kommandozeilenwerkzeugen:
Um ein Tag über eine Version zu erstellen:
<source lang="bash">
git tag -a -m "Release|Maintenance release x.y.z" "x.y.z"
oder
git tag -a -f -m "Beta x.y.betai" "x.y.betai_YYYYMMDD" idcommit # -f force wenn ein Tag bereits existiert, ermöglicht idcommit die Auswahl des zu taggenden Commits.
git push --tags # Pour pousser le tags sur le serveur distant
</source>

Um einen Tag zu löschen:
<source lang="bash">
git tag -d "x.y.z_YYYYMMDD"
git push origin :x.y.z_YYYYMMDD # Um die Löschung auf dem entfernten Server zu bestätigen
</source>

=Einen neue Branche erstellen=
Hier ist der Befehl, den Sie verwenden müssen, um einen neuen Zweig aus einem eigenen develop-Repository zu erstellen:
<source lang="bash">
git branch x.y
git push origin x.y
</source>

=Statistiken=
Mit den GIT-Kommandozeilenwerkzeugen:

Um die Anzahl der Änderungen zu zählen, die ein Entwickler zwischen Version x und y vorgenommen hat:

*Zuerst führen Sie "git merge-base" aus, um die ID des letzten gemeinsamen Commits zwischen x und y zu erfahren.

<source lang="bash">
git merge-base origin/3.1 origin/develop
</source>

*Dann führen Sie git log aus, um eine Liste aller Änderungen von der letzten gemeinsamen Übertragung bis zur letzten Übertragung zu erhalten.
<source lang="bash">
git log id_found_at_previous_step..HEAD
</source>

*Um die Gesamtzahl der hinzugefügten/gelöschten Zeilen zu ermitteln:
<source lang="bash">
git log --ancestry-path --numstat --pretty="%H" id_found_at_previous_step..HEAD | awk 'NF==3 {plus+=$1; minus+=$2} END {printf("+%d, -%d\n", plus, minus)}'
</source>

Zählen der endgültigen Änderungen zwischen einer Version x und y (dies unterscheidet sich von der vorherigen Zählung, da bei der vorherigen Zählung eine Änderung zweimal zu zwei verschiedenen Zeitpunkten durchgeführt werden kann, um unterschiedliche Änderungen vorzunehmen. Bei der zweiten Methode werden die Änderungen gezählt, die schließlich gefunden wurden, wenn die Änderungen beim ersten Versuch in Ordnung waren):

*Verwenden Sie die gleiche Methode wie zuvor, aber anstatt git log auszuführen, führen Sie '''git diff''' aus.

<source lang="bash">
git diff -b -M --numstat --pretty="%H" id_found_at_previous_step..HEAD | awk 'NF==3 {plus+=$1; minus+=$2} END {printf("+%d, -%d\n", plus, minus)}'
</source>

Weitere Informationen über die Verwendung von GIT erhältlich unter: [http://wiki.eclipse.org/EGit/User_Guide ici].

[[Category:Development]]

FAQ Get, update GIT Projekt Quellen

2022-09-23T15:25:39Z

Speaking services: /* Voraussetzungen */

[[en:FAQ_Get,_update_GIT_Projekt_Quellen]]
[[fr:FAQ_Récupérer,_mettre_à_jour_les_sources_GIT_du_projet]]
[[es:FAQ_Recuperar,_actualizar_GIT_fuentes_del_proyecto]]


[[Category:FAQ DE]]
Hier finden Sie Informationen darüber, wie Sie die Quellen des Dolibarr-Projekts erhalten können.
Es werden mehrere Methoden beschrieben, aber wir empfehlen, die auf GitHub basierende Methode zu verwenden.

 

=Letzte Version der Quellen durch tgz-Download abrufen=
Diese Methode kann auch von nicht-technischen Benutzern verwendet werden.
Sie ermöglicht es Ihnen, die Quellen des Hauptentwicklungszweigs (HEAD genannt) zu erhalten, indem Sie einfach eine Datei herunterladen: Diese Operation besteht darin, die letzte Version der Dolibarr-Dateien zu erhalten, die jede Nacht in eine tgz-Datei gepackt werden. Die Datei ist über einen Link verfügbar:

{{LinkLastSnapshot}}

Neue Dateien überschreiben alte Dateien.
Der Nachteil dieser Methode ist, dass Sie das Paket jedes Mal herunterladen und dekomprimieren müssen, wenn Sie Updates erhalten möchten.

Entwickler sollten diese Methode nicht verwenden, um Quellen zu erhalten, sondern die nächste.

=Letzte Version der Quellen über einen anonymen GIT-Zugang abrufen=
Sie können diese Methode verwenden, wenn Sie keinen GIT-Zugang haben. Mit dieser Methode können Sie keine Änderungen einreichen. Wenn Sie also ein Entwickler sind, sollten Sie ein GitHub-Konto erstellen und die nächste Methode anstelle dieser Methode verwenden.

==Voraussetzungen==

*Mit Eclipse IDE

Zuerst müssen Sie eine funktionierende Installation von Eclipse haben. Das '''EGit'''-Plugin muss ebenfalls installiert worden sein.
Verwenden Sie dazu den '''Find And Install process''' im Eclipse Menü, fügen Sie die GIT update URL hinzu:
https://download.eclipse.org/egit/updates
Wählen Sie dann '''EGit''' zur Installation aus (JGit muss nicht ausgewählt werden)

*Mit der GIT-Kommandozeilen-Client-Schnittstelle

Sie müssen den GIT-Client installieren (das GIT-Befehlszeilentool wird unter Linux mit "sudo apt-get install git" installiert, für Windows ist der GIT-Client unter https://git-scm.com/download/win zu finden).

==Clone process==
First, enter value of the repository with reference sources into your GIT client tool.

*With Eclipse, go into perspective GIT, click onto button "Clone GIT repository". Enter GIT URL of project to get.

GIT Url for Dolibarr official source is:
<source lang="ini">
git://github.com/Dolibarr/dolibarr.git (read only)
or if you created a fork of dolibarr github from github web interface
git@github.com:yourgitaccount/dolibarr.git (read and write access)
</source>
Your Eclipse GIT client will ask you to choose the branches you are interested in. Branches not selected now could be selected later by doing a "Fetch" from the "Remotes" view, but try to choose only the branch you need. This will save you time and problems later.

Note: if you are behind a firewall, you must set Eclipse proxy credentials into Eclipse menu Windows - Preferences - General - Network connection and use the alternative URL:
<source lang="ini">
https://gitlogin:gitpassword@github.com/yourgitaccount/dolibarr.git
</source>

*With GIT on Command Line Interface:

First setup your git client:
<source lang="bash">
git config --global user.name "Your Name"
git config --global user.email "user@domain.com"
git config --list
</source>
Then clone repository locally:
<source lang="bash">
git://github.com/Dolibarr/dolibarr.git (read only)
or if you created a fork of dolibarr github from github web interface
git@github.com:yourgitaccount/dolibarr.git (read and write access)
</source>

Note: if you are behind a firewall, you must set your porxy information and use the alternative https URL:
<source lang="bash">
git config --global http.proxy http://proxyuser:proxypass@proxyserver:proxyport
git clone https://gitlogin:gitpassword@github.com/yourgitaccount/dolibarr.git dolibarr
</source>

Once this step is validated, your GIT client will download all files from remote GIT server. This may last several seconds or minutes.

Once download is finished, you must choose which branch to us to work on.

*With GIT on Command Line Interface;

<source lang="bash">
git checkout develop
git checkout x.y
</source>
This will create local branch and make checkout automatically.

*With Eclipse, right click on "Branches - Remotes - The branch you want to duplicate locally".

Choose "Create Branch" (and check the box "Checkout"). This will duplicate content of branch to work on it locally and will refresh your "Working Directory" to work on this branch.

Create Eclipse project:

If using Eclipse, once your branch is created locally, create a PHP project from assistant by choosing "'''Create from existing project'''" and select directory that is your GIT local repository (Do not choose to create a PHP project from scratch).
Then right click on project from your Eclipse workspace and Choose "'''Team - Share'''". Select GIT and click on option "'''Use or create repository in parent folder of project'''".
An alternate method is File->Import, Git->Project from Git, Select the Git repository and Next, Use New project Wizard -> Php project, enter the folder of you GIT local repository.

Then, you can setup Eclipse to avoid it to scan all project files for its build tools (Outline scanner, TODO scanner, syntax scanner...). This will avoid Eclipse to be too slow. For this, right click on project, choose Build Path and setup it like into following screenshot.

[[File:Eclipse php build path.png|240px]]

=Get last version of sources using a GitHub user access=
==Prerequisite==

*With Eclipse IDE

You must before create an account on GitHub (https://github.com/) and upload a public RSA or DSA certificate into your account profile.

Then, you must have a working install of Eclipse. '''EGit''' plugin must also have been installed.
For this, use the '''Find And Install process''' into Eclipse menu, add the GIT update URL:
https://download.eclipse.org/egit/updates
Then choose to install '''EGit'''.

*With the GIT Command Line Client Interface:

You must before create an account on GitHub (https://github.com/) and upload a public RSA or DSA certificate into your account profile.

Then, you need to install GIT client (GIT command line tool with Linux installed with "sudo apt-get install git", or the GIT client for Windows found at https://git-scm.com/download/win).

==Fork process==
Login to Github, with login you created in previous step. Then go onto page

https://github.com/Dolibarr/dolibarr

And click on button "Fork".

This will create a copy (a fork) of project into your own github area. Because you will be the owner of this fork, you will have all permissions on it to be used in next steps.

==Clone process==
Then process is same as getting sources with anonymous access.

URL to use for GIT clone is same:
<source lang="ini">
git@github.com:YourGitHubLogin/dolibarr.git
</source>

Note that a HTTPS URL is also available but it's sometimes offline (so prefer using first one, link with HTTPS is required only if you are behind a firewall):

<source lang="ini">
https://yourgithublogin@github.com/Dolibarr/dolibarr.git
</source>

=Update your repository=
To update your local workspace:

*With Eclipse IDE:

right click on Eclipse project and select "Pull".

If you made some changes into your Eclipse workspace on files that were changed into the GIT remote reference, your GIT client will make a merge automatically.

*If there is conflicts, the merge will mark all conflict files as "conflict" (See later to solve this state).
*If not, you will get all new version files including all your changes.

If you already have commited some files into your local repository, your workspace will be marked as "Merged".
All you have to do is make a commit to validate your local repository as including your changes and changes made by others.

*With the GIT Command Line Client Interface:

<source lang="bash">
git pull
</source>

=Commit and publish your changes=
To see all changes you made into your working directory and waiting to be added into Git:

*With GIT Command Line Interface:

<source lang="bash">
git status
git diff subdir/filename
</source>

To add changes made into your local repository into the GIT index, then commit this index :

*With Eclipse: Right click on file or directory to commit. Select file to add/remove/update into commit.
*With GIT Command Line Interface:

<source lang="bash">
git commit -a -m "Commit text"
</source>
This will save add and changes into your local branch.

To push them on the GIT repository server,

*With Eclipse: right click on project and choose "'''Team - Push to Upstream'''".
*With GIT Command Line Interface:

<source lang="bash">
git push
</source>

To cancel a commit:

*With GIT Command Line Interface, if commit was not already pushed:

<source lang="bash">
git reset --soft HEAD~1
</source>

*With GIT Command Line Interface, if commit was already pushed:

<source lang="bash">
git revert IdCommit or git revert HEAD (for last commit)
</source>

To merge changes done into your forked GIT instance into official Dolibarr instance:

*Go into GitHub web interface of your forked Git instance.
*Click on small button "Create a Pull request".
*Choose commit you request inclusion and validate.

=Ask official project to include your changes=
Once you pushed one or several commit toward your distant fork area on github, you can ask the Dolibarr core team to include it into official project.
For this, follow this tutorial: https://help.github.com/articles/creating-a-pull-request/

=Add an external commit into current repository=
Some developers may work and do commit into their own Git repository after forking the project. If you are interesting into getting this changes, you can import them with the following steps.

You need both Eclipse and GIT Command Line interface to achieve this:

*First, go into GIT setup view and right click on "'''Remotes'''" of your Eclipse Git working space and choose "'''Create a remote...'''"
*Type name or remote fork the developer has create (in most cases, it's developer Git login). For example: "'''thedevlogin'''". Choose also "'''Configure Fetch'''".
*Type URI of Git repository of developer. For example: '''git://github.com/thedevlogin/dolibarr.git'''. Also add a refspec value to declare the branch you want to get. For example: '''refs/heads/master:refs/remotes/thedevlogin/master'''. Click "'''Save and Fetch'''". A new entry will be added into "Remote Tracking" making possible to read/get commits done into this branch.

Now, go on command line of your git repository (in most cases on Linux, it's '''/home/yourlogin/git/yourdolibarr''') and type the git cherry-pick command:
<source lang="bash">
git cherry-pick -x commitid
</source>
where commitid is value of commit id you want to get.

Once this is done, go back to Eclipse and make a refresh on project. You will see modified files appears with decorators (with conflicts if there is).

It the cherry-pick fails because of conflicts, you can cancel the cherry-pick try with
<source lang="bash">
git cherry-pick --abort
</source>

=Solving a conflict=
If a file has been marked as "conflict" after a Pull, open the file to edit it.
Find string "<<<<<<<<<<", you will see part of code that is conflict between "<<<<<<<<<" and ">>>>>>>>". Edit manually code lines and remove "<<<<<<<<" and ">>>>>>>".

Then, right click on file and select "Add".

If you prefer to forget completely all changes you made into all files (so to restore you workspace with content of remote repository), you can make a hard reset:

*With Eclipse: Right click on project top line and select "'''Reset'''" then "'''Hard'''" then "'''Reference - HEAD'''".
*With GIT Command Line Interface: You can achieve this with command

<source lang="bash">
git reset --hard HEAD
</source>
To reset changes you commited but not pushed to origin
<source lang="bash">
git reset --hard origin/develop
</source>

=Tagging sources=
With GIT Command Line Interface:

To add a tag to a current version:
<source lang="bash">
git tag -a -m "Release|Maintenance release x.y.z" "x.y.z"
or
git tag -a -f -m "Beta x.y.betai" "x.y.betai_YYYYMMDD" idcommit # -f force if an existing tag already exists, idcommit allows to choose commit to tag

git push --tags # To push tags to remote origin
</source>

To remove a tag:
<source lang="bash">
git tag -d "x.y.z_YYYYMMDD"
git push remoteentryname :x.y.z_YYYYMMDD # To validate delete on remote origin
</source>

=Creating a new branch=
With GIT Command Line Interface:

Create a clone (see previously) of the branch from where you want to create another branch, then go into directory and launch command:
<source lang="bash">
git branch x.y
git push origin x.y
</source>

With Eclipse:

Create a clone (see previously) of the branch from where you want to create another branch, with a checkout done. The go into view git. Choose branches, remote tracking and select start branch.
Right click and choose "Create branch".
Then make a push to create branch remotely.
Then go into "Remotes - origins" and edit the entries to pull and push onto new branch.
It may also be required to edit the .git/config file to have project linked by default onto new branch.

=Deleting a branch=
With GIT Command Line Interface:

Do a push on branch but add : before name of branch:
<source lang="bash">
git push remoteentryname :branchnametodelete
</source>

=Merging a maintenance branch x.x into dev branch=
With Eclipse:

*Go onto the root directory of project with a checkout of the dev branch.
*Check fetch setup to be sure, this repository contains both information of dev branch and version x.x you want to merge.
*Right click onto root directory and choose "Team - Merge". Select "x.x". Click onto "Merge options - Commit", because we want to commit merged branch if there is no conflicts.
*Once merge is done, check everything is ok.
*Commit and push.

=Pushing a branch onto another Git server=
You may want to synchronize another GIT server.
To synchronize push to another server, this is how to proceed.
With Eclipse:

*Go onto Git clone view and add a remote with a name, choose "Configure push" and enter URL. For example, for name "sourceforge" and URL "ssh://yoursourceforgelogin@git.code.sf.net/p/dolibarr/code"
*Just validate, a first push will be done automatically.
*To force sync, run

<source lang="bash">
git push sourceforge develop
git push --tags sourceforge develop
</source>

=Statistics=
With GIT Command Line interface:

To count number of changes developers have made between a version x and y:

*First, search commit id of tags you want to compare

To find id_start (common commit id between 2 versions/tags)
<source lang="bash">
git merge-base refs/tags/3.3.0 origin/3.4
or
git merge-base 3.7 origin/develop
</source>
To find id_end, choose among
<source lang="bash">
git show-ref
</source>
Choose a value for id_start and id_end
Note: id_end can be HEAD.

*Then run git log to have list of all changes from last common commit to last commit

<source lang="bash">
git log id_start..id_end
</source>

*To get total number of added/deleted lines:

<source lang="bash">
git log --ancestry-path --numstat --pretty="%H" id_start..id_end | awk 'NF==3 {plus+=$1; minus+=$2} END {printf("+%d, -%d\n", plus, minus)}'
</source>

To count number of changes finally between a version x and y (it differs from previous count because in previous count, a change can be done 2 times at two different moment to change differently. With second method, you count changes finally found if changes were ok at first try).

*Use same method than previously but instead of running git log, run git diff.

<source lang="bash">
git diff -b -M --numstat --pretty="%H" id_start..id_end | awk 'NF==3 {plus+=$1; minus+=$2} END {printf("+%d, -%d\n", plus, minus)}'
</source>

More information in GIT usage is available [http://wiki.eclipse.org/EGit/User_Guide here].
[[Category:Development]]

FAQ Get, update GIT Projekt Quellen

2022-09-23T15:23:36Z

Speaking services: /* Prerequisite */

[[en:FAQ_Get,_update_GIT_Projekt_Quellen]]
[[fr:FAQ_Récupérer,_mettre_à_jour_les_sources_GIT_du_projet]]
[[es:FAQ_Recuperar,_actualizar_GIT_fuentes_del_proyecto]]


[[Category:FAQ DE]]
Hier finden Sie Informationen darüber, wie Sie die Quellen des Dolibarr-Projekts erhalten können.
Es werden mehrere Methoden beschrieben, aber wir empfehlen, die auf GitHub basierende Methode zu verwenden.

 

=Letzte Version der Quellen durch tgz-Download abrufen=
Diese Methode kann auch von nicht-technischen Benutzern verwendet werden.
Sie ermöglicht es Ihnen, die Quellen des Hauptentwicklungszweigs (HEAD genannt) zu erhalten, indem Sie einfach eine Datei herunterladen: Diese Operation besteht darin, die letzte Version der Dolibarr-Dateien zu erhalten, die jede Nacht in eine tgz-Datei gepackt werden. Die Datei ist über einen Link verfügbar:

{{LinkLastSnapshot}}

Neue Dateien überschreiben alte Dateien.
Der Nachteil dieser Methode ist, dass Sie das Paket jedes Mal herunterladen und dekomprimieren müssen, wenn Sie Updates erhalten möchten.

Entwickler sollten diese Methode nicht verwenden, um Quellen zu erhalten, sondern die nächste.

=Letzte Version der Quellen über einen anonymen GIT-Zugang abrufen=
Sie können diese Methode verwenden, wenn Sie keinen GIT-Zugang haben. Mit dieser Methode können Sie keine Änderungen einreichen. Wenn Sie also ein Entwickler sind, sollten Sie ein GitHub-Konto erstellen und die nächste Methode anstelle dieser Methode verwenden.

==Voraussetzungen==

*Mit Eclipse IDE

Zuerst müssen Sie eine funktionierende Installation von Eclipse haben. Das '''EGit'''-Plugin muss ebenfalls installiert worden sein.
Verwenden Sie dazu den '''Find And Install process''' im Eclipse Menü, fügen Sie die GIT update URL hinzu:
https://download.eclipse.org/egit/updates
Wählen Sie dann '''EGit''' zur Installation aus (JGit muss nicht ausgewählt werden)

*Mit der GIT-Kommandozeilen-Client-Schnittstelle

Sie müssen den GIT-Client installieren (das GIT-Befehlszeilentool wird unter Linux mit "sudo apt-get install git" installiert, oder der GIT-Client für Windows ist unter https://git-scm.com/download/win zu finden).

==Clone process==
First, enter value of the repository with reference sources into your GIT client tool.

*With Eclipse, go into perspective GIT, click onto button "Clone GIT repository". Enter GIT URL of project to get.

GIT Url for Dolibarr official source is:
<source lang="ini">
git://github.com/Dolibarr/dolibarr.git (read only)
or if you created a fork of dolibarr github from github web interface
git@github.com:yourgitaccount/dolibarr.git (read and write access)
</source>
Your Eclipse GIT client will ask you to choose the branches you are interested in. Branches not selected now could be selected later by doing a "Fetch" from the "Remotes" view, but try to choose only the branch you need. This will save you time and problems later.

Note: if you are behind a firewall, you must set Eclipse proxy credentials into Eclipse menu Windows - Preferences - General - Network connection and use the alternative URL:
<source lang="ini">
https://gitlogin:gitpassword@github.com/yourgitaccount/dolibarr.git
</source>

*With GIT on Command Line Interface:

First setup your git client:
<source lang="bash">
git config --global user.name "Your Name"
git config --global user.email "user@domain.com"
git config --list
</source>
Then clone repository locally:
<source lang="bash">
git://github.com/Dolibarr/dolibarr.git (read only)
or if you created a fork of dolibarr github from github web interface
git@github.com:yourgitaccount/dolibarr.git (read and write access)
</source>

Note: if you are behind a firewall, you must set your porxy information and use the alternative https URL:
<source lang="bash">
git config --global http.proxy http://proxyuser:proxypass@proxyserver:proxyport
git clone https://gitlogin:gitpassword@github.com/yourgitaccount/dolibarr.git dolibarr
</source>

Once this step is validated, your GIT client will download all files from remote GIT server. This may last several seconds or minutes.

Once download is finished, you must choose which branch to us to work on.

*With GIT on Command Line Interface;

<source lang="bash">
git checkout develop
git checkout x.y
</source>
This will create local branch and make checkout automatically.

*With Eclipse, right click on "Branches - Remotes - The branch you want to duplicate locally".

Choose "Create Branch" (and check the box "Checkout"). This will duplicate content of branch to work on it locally and will refresh your "Working Directory" to work on this branch.

Create Eclipse project:

If using Eclipse, once your branch is created locally, create a PHP project from assistant by choosing "'''Create from existing project'''" and select directory that is your GIT local repository (Do not choose to create a PHP project from scratch).
Then right click on project from your Eclipse workspace and Choose "'''Team - Share'''". Select GIT and click on option "'''Use or create repository in parent folder of project'''".
An alternate method is File->Import, Git->Project from Git, Select the Git repository and Next, Use New project Wizard -> Php project, enter the folder of you GIT local repository.

Then, you can setup Eclipse to avoid it to scan all project files for its build tools (Outline scanner, TODO scanner, syntax scanner...). This will avoid Eclipse to be too slow. For this, right click on project, choose Build Path and setup it like into following screenshot.

[[File:Eclipse php build path.png|240px]]

=Get last version of sources using a GitHub user access=
==Prerequisite==

*With Eclipse IDE

You must before create an account on GitHub (https://github.com/) and upload a public RSA or DSA certificate into your account profile.

Then, you must have a working install of Eclipse. '''EGit''' plugin must also have been installed.
For this, use the '''Find And Install process''' into Eclipse menu, add the GIT update URL:
https://download.eclipse.org/egit/updates
Then choose to install '''EGit'''.

*With the GIT Command Line Client Interface:

You must before create an account on GitHub (https://github.com/) and upload a public RSA or DSA certificate into your account profile.

Then, you need to install GIT client (GIT command line tool with Linux installed with "sudo apt-get install git", or the GIT client for Windows found at https://git-scm.com/download/win).

==Fork process==
Login to Github, with login you created in previous step. Then go onto page

https://github.com/Dolibarr/dolibarr

And click on button "Fork".

This will create a copy (a fork) of project into your own github area. Because you will be the owner of this fork, you will have all permissions on it to be used in next steps.

==Clone process==
Then process is same as getting sources with anonymous access.

URL to use for GIT clone is same:
<source lang="ini">
git@github.com:YourGitHubLogin/dolibarr.git
</source>

Note that a HTTPS URL is also available but it's sometimes offline (so prefer using first one, link with HTTPS is required only if you are behind a firewall):

<source lang="ini">
https://yourgithublogin@github.com/Dolibarr/dolibarr.git
</source>

=Update your repository=
To update your local workspace:

*With Eclipse IDE:

right click on Eclipse project and select "Pull".

If you made some changes into your Eclipse workspace on files that were changed into the GIT remote reference, your GIT client will make a merge automatically.

*If there is conflicts, the merge will mark all conflict files as "conflict" (See later to solve this state).
*If not, you will get all new version files including all your changes.

If you already have commited some files into your local repository, your workspace will be marked as "Merged".
All you have to do is make a commit to validate your local repository as including your changes and changes made by others.

*With the GIT Command Line Client Interface:

<source lang="bash">
git pull
</source>

=Commit and publish your changes=
To see all changes you made into your working directory and waiting to be added into Git:

*With GIT Command Line Interface:

<source lang="bash">
git status
git diff subdir/filename
</source>

To add changes made into your local repository into the GIT index, then commit this index :

*With Eclipse: Right click on file or directory to commit. Select file to add/remove/update into commit.
*With GIT Command Line Interface:

<source lang="bash">
git commit -a -m "Commit text"
</source>
This will save add and changes into your local branch.

To push them on the GIT repository server,

*With Eclipse: right click on project and choose "'''Team - Push to Upstream'''".
*With GIT Command Line Interface:

<source lang="bash">
git push
</source>

To cancel a commit:

*With GIT Command Line Interface, if commit was not already pushed:

<source lang="bash">
git reset --soft HEAD~1
</source>

*With GIT Command Line Interface, if commit was already pushed:

<source lang="bash">
git revert IdCommit or git revert HEAD (for last commit)
</source>

To merge changes done into your forked GIT instance into official Dolibarr instance:

*Go into GitHub web interface of your forked Git instance.
*Click on small button "Create a Pull request".
*Choose commit you request inclusion and validate.

=Ask official project to include your changes=
Once you pushed one or several commit toward your distant fork area on github, you can ask the Dolibarr core team to include it into official project.
For this, follow this tutorial: https://help.github.com/articles/creating-a-pull-request/

=Add an external commit into current repository=
Some developers may work and do commit into their own Git repository after forking the project. If you are interesting into getting this changes, you can import them with the following steps.

You need both Eclipse and GIT Command Line interface to achieve this:

*First, go into GIT setup view and right click on "'''Remotes'''" of your Eclipse Git working space and choose "'''Create a remote...'''"
*Type name or remote fork the developer has create (in most cases, it's developer Git login). For example: "'''thedevlogin'''". Choose also "'''Configure Fetch'''".
*Type URI of Git repository of developer. For example: '''git://github.com/thedevlogin/dolibarr.git'''. Also add a refspec value to declare the branch you want to get. For example: '''refs/heads/master:refs/remotes/thedevlogin/master'''. Click "'''Save and Fetch'''". A new entry will be added into "Remote Tracking" making possible to read/get commits done into this branch.

Now, go on command line of your git repository (in most cases on Linux, it's '''/home/yourlogin/git/yourdolibarr''') and type the git cherry-pick command:
<source lang="bash">
git cherry-pick -x commitid
</source>
where commitid is value of commit id you want to get.

Once this is done, go back to Eclipse and make a refresh on project. You will see modified files appears with decorators (with conflicts if there is).

It the cherry-pick fails because of conflicts, you can cancel the cherry-pick try with
<source lang="bash">
git cherry-pick --abort
</source>

=Solving a conflict=
If a file has been marked as "conflict" after a Pull, open the file to edit it.
Find string "<<<<<<<<<<", you will see part of code that is conflict between "<<<<<<<<<" and ">>>>>>>>". Edit manually code lines and remove "<<<<<<<<" and ">>>>>>>".

Then, right click on file and select "Add".

If you prefer to forget completely all changes you made into all files (so to restore you workspace with content of remote repository), you can make a hard reset:

*With Eclipse: Right click on project top line and select "'''Reset'''" then "'''Hard'''" then "'''Reference - HEAD'''".
*With GIT Command Line Interface: You can achieve this with command

<source lang="bash">
git reset --hard HEAD
</source>
To reset changes you commited but not pushed to origin
<source lang="bash">
git reset --hard origin/develop
</source>

=Tagging sources=
With GIT Command Line Interface:

To add a tag to a current version:
<source lang="bash">
git tag -a -m "Release|Maintenance release x.y.z" "x.y.z"
or
git tag -a -f -m "Beta x.y.betai" "x.y.betai_YYYYMMDD" idcommit # -f force if an existing tag already exists, idcommit allows to choose commit to tag

git push --tags # To push tags to remote origin
</source>

To remove a tag:
<source lang="bash">
git tag -d "x.y.z_YYYYMMDD"
git push remoteentryname :x.y.z_YYYYMMDD # To validate delete on remote origin
</source>

=Creating a new branch=
With GIT Command Line Interface:

Create a clone (see previously) of the branch from where you want to create another branch, then go into directory and launch command:
<source lang="bash">
git branch x.y
git push origin x.y
</source>

With Eclipse:

Create a clone (see previously) of the branch from where you want to create another branch, with a checkout done. The go into view git. Choose branches, remote tracking and select start branch.
Right click and choose "Create branch".
Then make a push to create branch remotely.
Then go into "Remotes - origins" and edit the entries to pull and push onto new branch.
It may also be required to edit the .git/config file to have project linked by default onto new branch.

=Deleting a branch=
With GIT Command Line Interface:

Do a push on branch but add : before name of branch:
<source lang="bash">
git push remoteentryname :branchnametodelete
</source>

=Merging a maintenance branch x.x into dev branch=
With Eclipse:

*Go onto the root directory of project with a checkout of the dev branch.
*Check fetch setup to be sure, this repository contains both information of dev branch and version x.x you want to merge.
*Right click onto root directory and choose "Team - Merge". Select "x.x". Click onto "Merge options - Commit", because we want to commit merged branch if there is no conflicts.
*Once merge is done, check everything is ok.
*Commit and push.

=Pushing a branch onto another Git server=
You may want to synchronize another GIT server.
To synchronize push to another server, this is how to proceed.
With Eclipse:

*Go onto Git clone view and add a remote with a name, choose "Configure push" and enter URL. For example, for name "sourceforge" and URL "ssh://yoursourceforgelogin@git.code.sf.net/p/dolibarr/code"
*Just validate, a first push will be done automatically.
*To force sync, run

<source lang="bash">
git push sourceforge develop
git push --tags sourceforge develop
</source>

=Statistics=
With GIT Command Line interface:

To count number of changes developers have made between a version x and y:

*First, search commit id of tags you want to compare

To find id_start (common commit id between 2 versions/tags)
<source lang="bash">
git merge-base refs/tags/3.3.0 origin/3.4
or
git merge-base 3.7 origin/develop
</source>
To find id_end, choose among
<source lang="bash">
git show-ref
</source>
Choose a value for id_start and id_end
Note: id_end can be HEAD.

*Then run git log to have list of all changes from last common commit to last commit

<source lang="bash">
git log id_start..id_end
</source>

*To get total number of added/deleted lines:

<source lang="bash">
git log --ancestry-path --numstat --pretty="%H" id_start..id_end | awk 'NF==3 {plus+=$1; minus+=$2} END {printf("+%d, -%d\n", plus, minus)}'
</source>

To count number of changes finally between a version x and y (it differs from previous count because in previous count, a change can be done 2 times at two different moment to change differently. With second method, you count changes finally found if changes were ok at first try).

*Use same method than previously but instead of running git log, run git diff.

<source lang="bash">
git diff -b -M --numstat --pretty="%H" id_start..id_end | awk 'NF==3 {plus+=$1; minus+=$2} END {printf("+%d, -%d\n", plus, minus)}'
</source>

More information in GIT usage is available [http://wiki.eclipse.org/EGit/User_Guide here].
[[Category:Development]]

FAQ Get, update GIT Projekt Quellen

2022-09-23T15:20:28Z

Speaking services:

[[en:FAQ_Get,_update_GIT_Projekt_Quellen]]
[[fr:FAQ_Récupérer,_mettre_à_jour_les_sources_GIT_du_projet]]
[[es:FAQ_Recuperar,_actualizar_GIT_fuentes_del_proyecto]]


[[Category:FAQ DE]]
Hier finden Sie Informationen darüber, wie Sie die Quellen des Dolibarr-Projekts erhalten können.
Es werden mehrere Methoden beschrieben, aber wir empfehlen, die auf GitHub basierende Methode zu verwenden.

 

=Letzte Version der Quellen durch tgz-Download abrufen=
Diese Methode kann auch von nicht-technischen Benutzern verwendet werden.
Sie ermöglicht es Ihnen, die Quellen des Hauptentwicklungszweigs (HEAD genannt) zu erhalten, indem Sie einfach eine Datei herunterladen: Diese Operation besteht darin, die letzte Version der Dolibarr-Dateien zu erhalten, die jede Nacht in eine tgz-Datei gepackt werden. Die Datei ist über einen Link verfügbar:

{{LinkLastSnapshot}}

Neue Dateien überschreiben alte Dateien.
Der Nachteil dieser Methode ist, dass Sie das Paket jedes Mal herunterladen und dekomprimieren müssen, wenn Sie Updates erhalten möchten.

Entwickler sollten diese Methode nicht verwenden, um Quellen zu erhalten, sondern die nächste.

=Letzte Version der Quellen über einen anonymen GIT-Zugang abrufen=
Sie können diese Methode verwenden, wenn Sie keinen GIT-Zugang haben. Mit dieser Methode können Sie keine Änderungen einreichen. Wenn Sie also ein Entwickler sind, sollten Sie ein GitHub-Konto erstellen und die nächste Methode anstelle dieser Methode verwenden.

==Prerequisite==

*With Eclipse IDE

First you must have a working install of Eclipse. '''EGit''' plugin must also have been installed.
For this, use the '''Find And Install process''' into Eclipse menu, add the GIT update URL:
https://download.eclipse.org/egit/updates
Then choose to install '''EGit''' (No need to choose JGit)

*With the GIT Command Line Client Interface

You need to install GIT client (GIT command line tool with Linux installed with "sudo apt-get install git", or the GIT client for Windows found at https://git-scm.com/download/win).

==Clone process==
First, enter value of the repository with reference sources into your GIT client tool.

*With Eclipse, go into perspective GIT, click onto button "Clone GIT repository". Enter GIT URL of project to get.

GIT Url for Dolibarr official source is:
<source lang="ini">
git://github.com/Dolibarr/dolibarr.git (read only)
or if you created a fork of dolibarr github from github web interface
git@github.com:yourgitaccount/dolibarr.git (read and write access)
</source>
Your Eclipse GIT client will ask you to choose the branches you are interested in. Branches not selected now could be selected later by doing a "Fetch" from the "Remotes" view, but try to choose only the branch you need. This will save you time and problems later.

Note: if you are behind a firewall, you must set Eclipse proxy credentials into Eclipse menu Windows - Preferences - General - Network connection and use the alternative URL:
<source lang="ini">
https://gitlogin:gitpassword@github.com/yourgitaccount/dolibarr.git
</source>

*With GIT on Command Line Interface:

First setup your git client:
<source lang="bash">
git config --global user.name "Your Name"
git config --global user.email "user@domain.com"
git config --list
</source>
Then clone repository locally:
<source lang="bash">
git://github.com/Dolibarr/dolibarr.git (read only)
or if you created a fork of dolibarr github from github web interface
git@github.com:yourgitaccount/dolibarr.git (read and write access)
</source>

Note: if you are behind a firewall, you must set your porxy information and use the alternative https URL:
<source lang="bash">
git config --global http.proxy http://proxyuser:proxypass@proxyserver:proxyport
git clone https://gitlogin:gitpassword@github.com/yourgitaccount/dolibarr.git dolibarr
</source>

Once this step is validated, your GIT client will download all files from remote GIT server. This may last several seconds or minutes.

Once download is finished, you must choose which branch to us to work on.

*With GIT on Command Line Interface;

<source lang="bash">
git checkout develop
git checkout x.y
</source>
This will create local branch and make checkout automatically.

*With Eclipse, right click on "Branches - Remotes - The branch you want to duplicate locally".

Choose "Create Branch" (and check the box "Checkout"). This will duplicate content of branch to work on it locally and will refresh your "Working Directory" to work on this branch.

Create Eclipse project:

If using Eclipse, once your branch is created locally, create a PHP project from assistant by choosing "'''Create from existing project'''" and select directory that is your GIT local repository (Do not choose to create a PHP project from scratch).
Then right click on project from your Eclipse workspace and Choose "'''Team - Share'''". Select GIT and click on option "'''Use or create repository in parent folder of project'''".
An alternate method is File->Import, Git->Project from Git, Select the Git repository and Next, Use New project Wizard -> Php project, enter the folder of you GIT local repository.

Then, you can setup Eclipse to avoid it to scan all project files for its build tools (Outline scanner, TODO scanner, syntax scanner...). This will avoid Eclipse to be too slow. For this, right click on project, choose Build Path and setup it like into following screenshot.

[[File:Eclipse php build path.png|240px]]

=Get last version of sources using a GitHub user access=
==Prerequisite==

*With Eclipse IDE

You must before create an account on GitHub (https://github.com/) and upload a public RSA or DSA certificate into your account profile.

Then, you must have a working install of Eclipse. '''EGit''' plugin must also have been installed.
For this, use the '''Find And Install process''' into Eclipse menu, add the GIT update URL:
https://download.eclipse.org/egit/updates
Then choose to install '''EGit'''.

*With the GIT Command Line Client Interface:

You must before create an account on GitHub (https://github.com/) and upload a public RSA or DSA certificate into your account profile.

Then, you need to install GIT client (GIT command line tool with Linux installed with "sudo apt-get install git", or the GIT client for Windows found at https://git-scm.com/download/win).

==Fork process==
Login to Github, with login you created in previous step. Then go onto page

https://github.com/Dolibarr/dolibarr

And click on button "Fork".

This will create a copy (a fork) of project into your own github area. Because you will be the owner of this fork, you will have all permissions on it to be used in next steps.

==Clone process==
Then process is same as getting sources with anonymous access.

URL to use for GIT clone is same:
<source lang="ini">
git@github.com:YourGitHubLogin/dolibarr.git
</source>

Note that a HTTPS URL is also available but it's sometimes offline (so prefer using first one, link with HTTPS is required only if you are behind a firewall):

<source lang="ini">
https://yourgithublogin@github.com/Dolibarr/dolibarr.git
</source>

=Update your repository=
To update your local workspace:

*With Eclipse IDE:

right click on Eclipse project and select "Pull".

If you made some changes into your Eclipse workspace on files that were changed into the GIT remote reference, your GIT client will make a merge automatically.

*If there is conflicts, the merge will mark all conflict files as "conflict" (See later to solve this state).
*If not, you will get all new version files including all your changes.

If you already have commited some files into your local repository, your workspace will be marked as "Merged".
All you have to do is make a commit to validate your local repository as including your changes and changes made by others.

*With the GIT Command Line Client Interface:

<source lang="bash">
git pull
</source>

=Commit and publish your changes=
To see all changes you made into your working directory and waiting to be added into Git:

*With GIT Command Line Interface:

<source lang="bash">
git status
git diff subdir/filename
</source>

To add changes made into your local repository into the GIT index, then commit this index :

*With Eclipse: Right click on file or directory to commit. Select file to add/remove/update into commit.
*With GIT Command Line Interface:

<source lang="bash">
git commit -a -m "Commit text"
</source>
This will save add and changes into your local branch.

To push them on the GIT repository server,

*With Eclipse: right click on project and choose "'''Team - Push to Upstream'''".
*With GIT Command Line Interface:

<source lang="bash">
git push
</source>

To cancel a commit:

*With GIT Command Line Interface, if commit was not already pushed:

<source lang="bash">
git reset --soft HEAD~1
</source>

*With GIT Command Line Interface, if commit was already pushed:

<source lang="bash">
git revert IdCommit or git revert HEAD (for last commit)
</source>

To merge changes done into your forked GIT instance into official Dolibarr instance:

*Go into GitHub web interface of your forked Git instance.
*Click on small button "Create a Pull request".
*Choose commit you request inclusion and validate.

=Ask official project to include your changes=
Once you pushed one or several commit toward your distant fork area on github, you can ask the Dolibarr core team to include it into official project.
For this, follow this tutorial: https://help.github.com/articles/creating-a-pull-request/

=Add an external commit into current repository=
Some developers may work and do commit into their own Git repository after forking the project. If you are interesting into getting this changes, you can import them with the following steps.

You need both Eclipse and GIT Command Line interface to achieve this:

*First, go into GIT setup view and right click on "'''Remotes'''" of your Eclipse Git working space and choose "'''Create a remote...'''"
*Type name or remote fork the developer has create (in most cases, it's developer Git login). For example: "'''thedevlogin'''". Choose also "'''Configure Fetch'''".
*Type URI of Git repository of developer. For example: '''git://github.com/thedevlogin/dolibarr.git'''. Also add a refspec value to declare the branch you want to get. For example: '''refs/heads/master:refs/remotes/thedevlogin/master'''. Click "'''Save and Fetch'''". A new entry will be added into "Remote Tracking" making possible to read/get commits done into this branch.

Now, go on command line of your git repository (in most cases on Linux, it's '''/home/yourlogin/git/yourdolibarr''') and type the git cherry-pick command:
<source lang="bash">
git cherry-pick -x commitid
</source>
where commitid is value of commit id you want to get.

Once this is done, go back to Eclipse and make a refresh on project. You will see modified files appears with decorators (with conflicts if there is).

It the cherry-pick fails because of conflicts, you can cancel the cherry-pick try with
<source lang="bash">
git cherry-pick --abort
</source>

=Solving a conflict=
If a file has been marked as "conflict" after a Pull, open the file to edit it.
Find string "<<<<<<<<<<", you will see part of code that is conflict between "<<<<<<<<<" and ">>>>>>>>". Edit manually code lines and remove "<<<<<<<<" and ">>>>>>>".

Then, right click on file and select "Add".

If you prefer to forget completely all changes you made into all files (so to restore you workspace with content of remote repository), you can make a hard reset:

*With Eclipse: Right click on project top line and select "'''Reset'''" then "'''Hard'''" then "'''Reference - HEAD'''".
*With GIT Command Line Interface: You can achieve this with command

<source lang="bash">
git reset --hard HEAD
</source>
To reset changes you commited but not pushed to origin
<source lang="bash">
git reset --hard origin/develop
</source>

=Tagging sources=
With GIT Command Line Interface:

To add a tag to a current version:
<source lang="bash">
git tag -a -m "Release|Maintenance release x.y.z" "x.y.z"
or
git tag -a -f -m "Beta x.y.betai" "x.y.betai_YYYYMMDD" idcommit # -f force if an existing tag already exists, idcommit allows to choose commit to tag

git push --tags # To push tags to remote origin
</source>

To remove a tag:
<source lang="bash">
git tag -d "x.y.z_YYYYMMDD"
git push remoteentryname :x.y.z_YYYYMMDD # To validate delete on remote origin
</source>

=Creating a new branch=
With GIT Command Line Interface:

Create a clone (see previously) of the branch from where you want to create another branch, then go into directory and launch command:
<source lang="bash">
git branch x.y
git push origin x.y
</source>

With Eclipse:

Create a clone (see previously) of the branch from where you want to create another branch, with a checkout done. The go into view git. Choose branches, remote tracking and select start branch.
Right click and choose "Create branch".
Then make a push to create branch remotely.
Then go into "Remotes - origins" and edit the entries to pull and push onto new branch.
It may also be required to edit the .git/config file to have project linked by default onto new branch.

=Deleting a branch=
With GIT Command Line Interface:

Do a push on branch but add : before name of branch:
<source lang="bash">
git push remoteentryname :branchnametodelete
</source>

=Merging a maintenance branch x.x into dev branch=
With Eclipse:

*Go onto the root directory of project with a checkout of the dev branch.
*Check fetch setup to be sure, this repository contains both information of dev branch and version x.x you want to merge.
*Right click onto root directory and choose "Team - Merge". Select "x.x". Click onto "Merge options - Commit", because we want to commit merged branch if there is no conflicts.
*Once merge is done, check everything is ok.
*Commit and push.

=Pushing a branch onto another Git server=
You may want to synchronize another GIT server.
To synchronize push to another server, this is how to proceed.
With Eclipse:

*Go onto Git clone view and add a remote with a name, choose "Configure push" and enter URL. For example, for name "sourceforge" and URL "ssh://yoursourceforgelogin@git.code.sf.net/p/dolibarr/code"
*Just validate, a first push will be done automatically.
*To force sync, run

<source lang="bash">
git push sourceforge develop
git push --tags sourceforge develop
</source>

=Statistics=
With GIT Command Line interface:

To count number of changes developers have made between a version x and y:

*First, search commit id of tags you want to compare

To find id_start (common commit id between 2 versions/tags)
<source lang="bash">
git merge-base refs/tags/3.3.0 origin/3.4
or
git merge-base 3.7 origin/develop
</source>
To find id_end, choose among
<source lang="bash">
git show-ref
</source>
Choose a value for id_start and id_end
Note: id_end can be HEAD.

*Then run git log to have list of all changes from last common commit to last commit

<source lang="bash">
git log id_start..id_end
</source>

*To get total number of added/deleted lines:

<source lang="bash">
git log --ancestry-path --numstat --pretty="%H" id_start..id_end | awk 'NF==3 {plus+=$1; minus+=$2} END {printf("+%d, -%d\n", plus, minus)}'
</source>

To count number of changes finally between a version x and y (it differs from previous count because in previous count, a change can be done 2 times at two different moment to change differently. With second method, you count changes finally found if changes were ok at first try).

*Use same method than previously but instead of running git log, run git diff.

<source lang="bash">
git diff -b -M --numstat --pretty="%H" id_start..id_end | awk 'NF==3 {plus+=$1; minus+=$2} END {printf("+%d, -%d\n", plus, minus)}'
</source>

More information in GIT usage is available [http://wiki.eclipse.org/EGit/User_Guide here].
[[Category:Development]]

FAQ Get, update GIT Projekt Quellen

2022-09-23T15:18:42Z

Speaking services:

[[en:FAQ_Get,_update_GIT_Projekt_Quellen]]
[[fr:FAQ_Récupérer,_mettre_à_jour_les_sources_GIT_du_projet]]
[[es:FAQ_Recuperar,_actualizar_GIT_fuentes_del_proyecto]]


[[Category:FAQ DE]]
Hier finden Sie Informationen darüber, wie Sie die Quellen des Dolibarr-Projekts erhalten können.
Es werden mehrere Methoden beschrieben, aber wir empfehlen, die auf GitHub basierende Methode zu verwenden.

 

=Letzte Version der Quellen durch tgz-Download abrufen=
Diese Methode kann auch von nicht-technischen Benutzern verwendet werden.
Sie ermöglicht es Ihnen, die Quellen des Hauptentwicklungszweigs (HEAD genannt) zu erhalten, indem Sie einfach eine Datei herunterladen: Diese Operation besteht darin, die letzte Version der Dolibarr-Dateien zu erhalten, die jede Nacht in eine tgz-Datei gepackt werden. Die Datei ist über einen Link verfügbar:

{{LinkLastSnapshot}}

Neue Dateien überschreiben alte Dateien.
Der Nachteil dieser Methode ist, dass Sie das Paket jedes Mal herunterladen und dekomprimieren müssen, wenn Sie Updates erhalten möchten.

Entwickler sollten diese Methode nicht verwenden, um Quellen zu erhalten, sondern die nächste.

=Get last version of sources using a GIT anonymous access=
You can use this method if you don't have any GIT access. With this method, you won't be able to submit any changes, so, if you are a developer, it is recommended to create a GitHub account and use the next method instead of this one.

==Prerequisite==

*With Eclipse IDE

First you must have a working install of Eclipse. '''EGit''' plugin must also have been installed.
For this, use the '''Find And Install process''' into Eclipse menu, add the GIT update URL:
https://download.eclipse.org/egit/updates
Then choose to install '''EGit''' (No need to choose JGit)

*With the GIT Command Line Client Interface

You need to install GIT client (GIT command line tool with Linux installed with "sudo apt-get install git", or the GIT client for Windows found at https://git-scm.com/download/win).

==Clone process==
First, enter value of the repository with reference sources into your GIT client tool.

*With Eclipse, go into perspective GIT, click onto button "Clone GIT repository". Enter GIT URL of project to get.

GIT Url for Dolibarr official source is:
<source lang="ini">
git://github.com/Dolibarr/dolibarr.git (read only)
or if you created a fork of dolibarr github from github web interface
git@github.com:yourgitaccount/dolibarr.git (read and write access)
</source>
Your Eclipse GIT client will ask you to choose the branches you are interested in. Branches not selected now could be selected later by doing a "Fetch" from the "Remotes" view, but try to choose only the branch you need. This will save you time and problems later.

Note: if you are behind a firewall, you must set Eclipse proxy credentials into Eclipse menu Windows - Preferences - General - Network connection and use the alternative URL:
<source lang="ini">
https://gitlogin:gitpassword@github.com/yourgitaccount/dolibarr.git
</source>

*With GIT on Command Line Interface:

First setup your git client:
<source lang="bash">
git config --global user.name "Your Name"
git config --global user.email "user@domain.com"
git config --list
</source>
Then clone repository locally:
<source lang="bash">
git://github.com/Dolibarr/dolibarr.git (read only)
or if you created a fork of dolibarr github from github web interface
git@github.com:yourgitaccount/dolibarr.git (read and write access)
</source>

Note: if you are behind a firewall, you must set your porxy information and use the alternative https URL:
<source lang="bash">
git config --global http.proxy http://proxyuser:proxypass@proxyserver:proxyport
git clone https://gitlogin:gitpassword@github.com/yourgitaccount/dolibarr.git dolibarr
</source>

Once this step is validated, your GIT client will download all files from remote GIT server. This may last several seconds or minutes.

Once download is finished, you must choose which branch to us to work on.

*With GIT on Command Line Interface;

<source lang="bash">
git checkout develop
git checkout x.y
</source>
This will create local branch and make checkout automatically.

*With Eclipse, right click on "Branches - Remotes - The branch you want to duplicate locally".

Choose "Create Branch" (and check the box "Checkout"). This will duplicate content of branch to work on it locally and will refresh your "Working Directory" to work on this branch.

Create Eclipse project:

If using Eclipse, once your branch is created locally, create a PHP project from assistant by choosing "'''Create from existing project'''" and select directory that is your GIT local repository (Do not choose to create a PHP project from scratch).
Then right click on project from your Eclipse workspace and Choose "'''Team - Share'''". Select GIT and click on option "'''Use or create repository in parent folder of project'''".
An alternate method is File->Import, Git->Project from Git, Select the Git repository and Next, Use New project Wizard -> Php project, enter the folder of you GIT local repository.

Then, you can setup Eclipse to avoid it to scan all project files for its build tools (Outline scanner, TODO scanner, syntax scanner...). This will avoid Eclipse to be too slow. For this, right click on project, choose Build Path and setup it like into following screenshot.

[[File:Eclipse php build path.png|240px]]

=Get last version of sources using a GitHub user access=
==Prerequisite==

*With Eclipse IDE

You must before create an account on GitHub (https://github.com/) and upload a public RSA or DSA certificate into your account profile.

Then, you must have a working install of Eclipse. '''EGit''' plugin must also have been installed.
For this, use the '''Find And Install process''' into Eclipse menu, add the GIT update URL:
https://download.eclipse.org/egit/updates
Then choose to install '''EGit'''.

*With the GIT Command Line Client Interface:

You must before create an account on GitHub (https://github.com/) and upload a public RSA or DSA certificate into your account profile.

Then, you need to install GIT client (GIT command line tool with Linux installed with "sudo apt-get install git", or the GIT client for Windows found at https://git-scm.com/download/win).

==Fork process==
Login to Github, with login you created in previous step. Then go onto page

https://github.com/Dolibarr/dolibarr

And click on button "Fork".

This will create a copy (a fork) of project into your own github area. Because you will be the owner of this fork, you will have all permissions on it to be used in next steps.

==Clone process==
Then process is same as getting sources with anonymous access.

URL to use for GIT clone is same:
<source lang="ini">
git@github.com:YourGitHubLogin/dolibarr.git
</source>

Note that a HTTPS URL is also available but it's sometimes offline (so prefer using first one, link with HTTPS is required only if you are behind a firewall):

<source lang="ini">
https://yourgithublogin@github.com/Dolibarr/dolibarr.git
</source>

=Update your repository=
To update your local workspace:

*With Eclipse IDE:

right click on Eclipse project and select "Pull".

If you made some changes into your Eclipse workspace on files that were changed into the GIT remote reference, your GIT client will make a merge automatically.

*If there is conflicts, the merge will mark all conflict files as "conflict" (See later to solve this state).
*If not, you will get all new version files including all your changes.

If you already have commited some files into your local repository, your workspace will be marked as "Merged".
All you have to do is make a commit to validate your local repository as including your changes and changes made by others.

*With the GIT Command Line Client Interface:

<source lang="bash">
git pull
</source>

=Commit and publish your changes=
To see all changes you made into your working directory and waiting to be added into Git:

*With GIT Command Line Interface:

<source lang="bash">
git status
git diff subdir/filename
</source>

To add changes made into your local repository into the GIT index, then commit this index :

*With Eclipse: Right click on file or directory to commit. Select file to add/remove/update into commit.
*With GIT Command Line Interface:

<source lang="bash">
git commit -a -m "Commit text"
</source>
This will save add and changes into your local branch.

To push them on the GIT repository server,

*With Eclipse: right click on project and choose "'''Team - Push to Upstream'''".
*With GIT Command Line Interface:

<source lang="bash">
git push
</source>

To cancel a commit:

*With GIT Command Line Interface, if commit was not already pushed:

<source lang="bash">
git reset --soft HEAD~1
</source>

*With GIT Command Line Interface, if commit was already pushed:

<source lang="bash">
git revert IdCommit or git revert HEAD (for last commit)
</source>

To merge changes done into your forked GIT instance into official Dolibarr instance:

*Go into GitHub web interface of your forked Git instance.
*Click on small button "Create a Pull request".
*Choose commit you request inclusion and validate.

=Ask official project to include your changes=
Once you pushed one or several commit toward your distant fork area on github, you can ask the Dolibarr core team to include it into official project.
For this, follow this tutorial: https://help.github.com/articles/creating-a-pull-request/

=Add an external commit into current repository=
Some developers may work and do commit into their own Git repository after forking the project. If you are interesting into getting this changes, you can import them with the following steps.

You need both Eclipse and GIT Command Line interface to achieve this:

*First, go into GIT setup view and right click on "'''Remotes'''" of your Eclipse Git working space and choose "'''Create a remote...'''"
*Type name or remote fork the developer has create (in most cases, it's developer Git login). For example: "'''thedevlogin'''". Choose also "'''Configure Fetch'''".
*Type URI of Git repository of developer. For example: '''git://github.com/thedevlogin/dolibarr.git'''. Also add a refspec value to declare the branch you want to get. For example: '''refs/heads/master:refs/remotes/thedevlogin/master'''. Click "'''Save and Fetch'''". A new entry will be added into "Remote Tracking" making possible to read/get commits done into this branch.

Now, go on command line of your git repository (in most cases on Linux, it's '''/home/yourlogin/git/yourdolibarr''') and type the git cherry-pick command:
<source lang="bash">
git cherry-pick -x commitid
</source>
where commitid is value of commit id you want to get.

Once this is done, go back to Eclipse and make a refresh on project. You will see modified files appears with decorators (with conflicts if there is).

It the cherry-pick fails because of conflicts, you can cancel the cherry-pick try with
<source lang="bash">
git cherry-pick --abort
</source>

=Solving a conflict=
If a file has been marked as "conflict" after a Pull, open the file to edit it.
Find string "<<<<<<<<<<", you will see part of code that is conflict between "<<<<<<<<<" and ">>>>>>>>". Edit manually code lines and remove "<<<<<<<<" and ">>>>>>>".

Then, right click on file and select "Add".

If you prefer to forget completely all changes you made into all files (so to restore you workspace with content of remote repository), you can make a hard reset:

*With Eclipse: Right click on project top line and select "'''Reset'''" then "'''Hard'''" then "'''Reference - HEAD'''".
*With GIT Command Line Interface: You can achieve this with command

<source lang="bash">
git reset --hard HEAD
</source>
To reset changes you commited but not pushed to origin
<source lang="bash">
git reset --hard origin/develop
</source>

=Tagging sources=
With GIT Command Line Interface:

To add a tag to a current version:
<source lang="bash">
git tag -a -m "Release|Maintenance release x.y.z" "x.y.z"
or
git tag -a -f -m "Beta x.y.betai" "x.y.betai_YYYYMMDD" idcommit # -f force if an existing tag already exists, idcommit allows to choose commit to tag

git push --tags # To push tags to remote origin
</source>

To remove a tag:
<source lang="bash">
git tag -d "x.y.z_YYYYMMDD"
git push remoteentryname :x.y.z_YYYYMMDD # To validate delete on remote origin
</source>

=Creating a new branch=
With GIT Command Line Interface:

Create a clone (see previously) of the branch from where you want to create another branch, then go into directory and launch command:
<source lang="bash">
git branch x.y
git push origin x.y
</source>

With Eclipse:

Create a clone (see previously) of the branch from where you want to create another branch, with a checkout done. The go into view git. Choose branches, remote tracking and select start branch.
Right click and choose "Create branch".
Then make a push to create branch remotely.
Then go into "Remotes - origins" and edit the entries to pull and push onto new branch.
It may also be required to edit the .git/config file to have project linked by default onto new branch.

=Deleting a branch=
With GIT Command Line Interface:

Do a push on branch but add : before name of branch:
<source lang="bash">
git push remoteentryname :branchnametodelete
</source>

=Merging a maintenance branch x.x into dev branch=
With Eclipse:

*Go onto the root directory of project with a checkout of the dev branch.
*Check fetch setup to be sure, this repository contains both information of dev branch and version x.x you want to merge.
*Right click onto root directory and choose "Team - Merge". Select "x.x". Click onto "Merge options - Commit", because we want to commit merged branch if there is no conflicts.
*Once merge is done, check everything is ok.
*Commit and push.

=Pushing a branch onto another Git server=
You may want to synchronize another GIT server.
To synchronize push to another server, this is how to proceed.
With Eclipse:

*Go onto Git clone view and add a remote with a name, choose "Configure push" and enter URL. For example, for name "sourceforge" and URL "ssh://yoursourceforgelogin@git.code.sf.net/p/dolibarr/code"
*Just validate, a first push will be done automatically.
*To force sync, run

<source lang="bash">
git push sourceforge develop
git push --tags sourceforge develop
</source>

=Statistics=
With GIT Command Line interface:

To count number of changes developers have made between a version x and y:

*First, search commit id of tags you want to compare

To find id_start (common commit id between 2 versions/tags)
<source lang="bash">
git merge-base refs/tags/3.3.0 origin/3.4
or
git merge-base 3.7 origin/develop
</source>
To find id_end, choose among
<source lang="bash">
git show-ref
</source>
Choose a value for id_start and id_end
Note: id_end can be HEAD.

*Then run git log to have list of all changes from last common commit to last commit

<source lang="bash">
git log id_start..id_end
</source>

*To get total number of added/deleted lines:

<source lang="bash">
git log --ancestry-path --numstat --pretty="%H" id_start..id_end | awk 'NF==3 {plus+=$1; minus+=$2} END {printf("+%d, -%d\n", plus, minus)}'
</source>

To count number of changes finally between a version x and y (it differs from previous count because in previous count, a change can be done 2 times at two different moment to change differently. With second method, you count changes finally found if changes were ok at first try).

*Use same method than previously but instead of running git log, run git diff.

<source lang="bash">
git diff -b -M --numstat --pretty="%H" id_start..id_end | awk 'NF==3 {plus+=$1; minus+=$2} END {printf("+%d, -%d\n", plus, minus)}'
</source>

More information in GIT usage is available [http://wiki.eclipse.org/EGit/User_Guide here].
[[Category:Development]]

FAQ Get, update GIT Projekt Quellen

2022-09-23T15:12:24Z

Speaking services:

[[en:FAQ_Get,_update_GIT_Projekt_Quellen]]
[[fr:FAQ_Récupérer,_mettre_à_jour_les_sources_GIT_du_projet]]
[[es:FAQ_Recuperar,_actualizar_GIT_fuentes_del_proyecto]]


[[Category:FAQ DE]]
Hier finden Sie Informationen darüber, wie Sie die Quellen des Dolibarr-Projekts erhalten können.
Es werden mehrere Methoden beschrieben, aber wir empfehlen, die auf GitHub basierende Methode zu verwenden.

 

=Letzte Version der Quellen durch tgz-Download abrufen=
Diese Methode kann auch von nicht-technischen Benutzern verwendet werden.
Sie ermöglicht es Ihnen, die Quellen des Hauptentwicklungszweigs (HEAD genannt) zu erhalten, indem Sie einfach eine Datei herunterladen: Diese Operation besteht darin, die letzte Version der Dolibarr-Dateien zu erhalten, die jede Nacht in eine tgz-Datei gepackt werden. Die Datei ist über einen Link verfügbar:

{{LinkLastSnapshot}}

New files overwrite old ones.
The inconvenient of this method is that you must download and uncompress package each time you want to get updates.

Developers should not use this method to get sources but the next one.

=Get last version of sources using a GIT anonymous access=
You can use this method if you don't have any GIT access. With this method, you won't be able to submit any changes, so, if you are a developer, it is recommended to create a GitHub account and use the next method instead of this one.

==Prerequisite==

*With Eclipse IDE

First you must have a working install of Eclipse. '''EGit''' plugin must also have been installed.
For this, use the '''Find And Install process''' into Eclipse menu, add the GIT update URL:
https://download.eclipse.org/egit/updates
Then choose to install '''EGit''' (No need to choose JGit)

*With the GIT Command Line Client Interface

You need to install GIT client (GIT command line tool with Linux installed with "sudo apt-get install git", or the GIT client for Windows found at https://git-scm.com/download/win).

==Clone process==
First, enter value of the repository with reference sources into your GIT client tool.

*With Eclipse, go into perspective GIT, click onto button "Clone GIT repository". Enter GIT URL of project to get.

GIT Url for Dolibarr official source is:
<source lang="ini">
git://github.com/Dolibarr/dolibarr.git (read only)
or if you created a fork of dolibarr github from github web interface
git@github.com:yourgitaccount/dolibarr.git (read and write access)
</source>
Your Eclipse GIT client will ask you to choose the branches you are interested in. Branches not selected now could be selected later by doing a "Fetch" from the "Remotes" view, but try to choose only the branch you need. This will save you time and problems later.

Note: if you are behind a firewall, you must set Eclipse proxy credentials into Eclipse menu Windows - Preferences - General - Network connection and use the alternative URL:
<source lang="ini">
https://gitlogin:gitpassword@github.com/yourgitaccount/dolibarr.git
</source>

*With GIT on Command Line Interface:

First setup your git client:
<source lang="bash">
git config --global user.name "Your Name"
git config --global user.email "user@domain.com"
git config --list
</source>
Then clone repository locally:
<source lang="bash">
git://github.com/Dolibarr/dolibarr.git (read only)
or if you created a fork of dolibarr github from github web interface
git@github.com:yourgitaccount/dolibarr.git (read and write access)
</source>

Note: if you are behind a firewall, you must set your porxy information and use the alternative https URL:
<source lang="bash">
git config --global http.proxy http://proxyuser:proxypass@proxyserver:proxyport
git clone https://gitlogin:gitpassword@github.com/yourgitaccount/dolibarr.git dolibarr
</source>

Once this step is validated, your GIT client will download all files from remote GIT server. This may last several seconds or minutes.

Once download is finished, you must choose which branch to us to work on.

*With GIT on Command Line Interface;

<source lang="bash">
git checkout develop
git checkout x.y
</source>
This will create local branch and make checkout automatically.

*With Eclipse, right click on "Branches - Remotes - The branch you want to duplicate locally".

Choose "Create Branch" (and check the box "Checkout"). This will duplicate content of branch to work on it locally and will refresh your "Working Directory" to work on this branch.

Create Eclipse project:

If using Eclipse, once your branch is created locally, create a PHP project from assistant by choosing "'''Create from existing project'''" and select directory that is your GIT local repository (Do not choose to create a PHP project from scratch).
Then right click on project from your Eclipse workspace and Choose "'''Team - Share'''". Select GIT and click on option "'''Use or create repository in parent folder of project'''".
An alternate method is File->Import, Git->Project from Git, Select the Git repository and Next, Use New project Wizard -> Php project, enter the folder of you GIT local repository.

Then, you can setup Eclipse to avoid it to scan all project files for its build tools (Outline scanner, TODO scanner, syntax scanner...). This will avoid Eclipse to be too slow. For this, right click on project, choose Build Path and setup it like into following screenshot.

[[File:Eclipse php build path.png|240px]]

=Get last version of sources using a GitHub user access=
==Prerequisite==

*With Eclipse IDE

You must before create an account on GitHub (https://github.com/) and upload a public RSA or DSA certificate into your account profile.

Then, you must have a working install of Eclipse. '''EGit''' plugin must also have been installed.
For this, use the '''Find And Install process''' into Eclipse menu, add the GIT update URL:
https://download.eclipse.org/egit/updates
Then choose to install '''EGit'''.

*With the GIT Command Line Client Interface:

You must before create an account on GitHub (https://github.com/) and upload a public RSA or DSA certificate into your account profile.

Then, you need to install GIT client (GIT command line tool with Linux installed with "sudo apt-get install git", or the GIT client for Windows found at https://git-scm.com/download/win).

==Fork process==
Login to Github, with login you created in previous step. Then go onto page

https://github.com/Dolibarr/dolibarr

And click on button "Fork".

This will create a copy (a fork) of project into your own github area. Because you will be the owner of this fork, you will have all permissions on it to be used in next steps.

==Clone process==
Then process is same as getting sources with anonymous access.

URL to use for GIT clone is same:
<source lang="ini">
git@github.com:YourGitHubLogin/dolibarr.git
</source>

Note that a HTTPS URL is also available but it's sometimes offline (so prefer using first one, link with HTTPS is required only if you are behind a firewall):

<source lang="ini">
https://yourgithublogin@github.com/Dolibarr/dolibarr.git
</source>

=Update your repository=
To update your local workspace:

*With Eclipse IDE:

right click on Eclipse project and select "Pull".

If you made some changes into your Eclipse workspace on files that were changed into the GIT remote reference, your GIT client will make a merge automatically.

*If there is conflicts, the merge will mark all conflict files as "conflict" (See later to solve this state).
*If not, you will get all new version files including all your changes.

If you already have commited some files into your local repository, your workspace will be marked as "Merged".
All you have to do is make a commit to validate your local repository as including your changes and changes made by others.

*With the GIT Command Line Client Interface:

<source lang="bash">
git pull
</source>

=Commit and publish your changes=
To see all changes you made into your working directory and waiting to be added into Git:

*With GIT Command Line Interface:

<source lang="bash">
git status
git diff subdir/filename
</source>

To add changes made into your local repository into the GIT index, then commit this index :

*With Eclipse: Right click on file or directory to commit. Select file to add/remove/update into commit.
*With GIT Command Line Interface:

<source lang="bash">
git commit -a -m "Commit text"
</source>
This will save add and changes into your local branch.

To push them on the GIT repository server,

*With Eclipse: right click on project and choose "'''Team - Push to Upstream'''".
*With GIT Command Line Interface:

<source lang="bash">
git push
</source>

To cancel a commit:

*With GIT Command Line Interface, if commit was not already pushed:

<source lang="bash">
git reset --soft HEAD~1
</source>

*With GIT Command Line Interface, if commit was already pushed:

<source lang="bash">
git revert IdCommit or git revert HEAD (for last commit)
</source>

To merge changes done into your forked GIT instance into official Dolibarr instance:

*Go into GitHub web interface of your forked Git instance.
*Click on small button "Create a Pull request".
*Choose commit you request inclusion and validate.

=Ask official project to include your changes=
Once you pushed one or several commit toward your distant fork area on github, you can ask the Dolibarr core team to include it into official project.
For this, follow this tutorial: https://help.github.com/articles/creating-a-pull-request/

=Add an external commit into current repository=
Some developers may work and do commit into their own Git repository after forking the project. If you are interesting into getting this changes, you can import them with the following steps.

You need both Eclipse and GIT Command Line interface to achieve this:

*First, go into GIT setup view and right click on "'''Remotes'''" of your Eclipse Git working space and choose "'''Create a remote...'''"
*Type name or remote fork the developer has create (in most cases, it's developer Git login). For example: "'''thedevlogin'''". Choose also "'''Configure Fetch'''".
*Type URI of Git repository of developer. For example: '''git://github.com/thedevlogin/dolibarr.git'''. Also add a refspec value to declare the branch you want to get. For example: '''refs/heads/master:refs/remotes/thedevlogin/master'''. Click "'''Save and Fetch'''". A new entry will be added into "Remote Tracking" making possible to read/get commits done into this branch.

Now, go on command line of your git repository (in most cases on Linux, it's '''/home/yourlogin/git/yourdolibarr''') and type the git cherry-pick command:
<source lang="bash">
git cherry-pick -x commitid
</source>
where commitid is value of commit id you want to get.

Once this is done, go back to Eclipse and make a refresh on project. You will see modified files appears with decorators (with conflicts if there is).

It the cherry-pick fails because of conflicts, you can cancel the cherry-pick try with
<source lang="bash">
git cherry-pick --abort
</source>

=Solving a conflict=
If a file has been marked as "conflict" after a Pull, open the file to edit it.
Find string "<<<<<<<<<<", you will see part of code that is conflict between "<<<<<<<<<" and ">>>>>>>>". Edit manually code lines and remove "<<<<<<<<" and ">>>>>>>".

Then, right click on file and select "Add".

If you prefer to forget completely all changes you made into all files (so to restore you workspace with content of remote repository), you can make a hard reset:

*With Eclipse: Right click on project top line and select "'''Reset'''" then "'''Hard'''" then "'''Reference - HEAD'''".
*With GIT Command Line Interface: You can achieve this with command

<source lang="bash">
git reset --hard HEAD
</source>
To reset changes you commited but not pushed to origin
<source lang="bash">
git reset --hard origin/develop
</source>

=Tagging sources=
With GIT Command Line Interface:

To add a tag to a current version:
<source lang="bash">
git tag -a -m "Release|Maintenance release x.y.z" "x.y.z"
or
git tag -a -f -m "Beta x.y.betai" "x.y.betai_YYYYMMDD" idcommit # -f force if an existing tag already exists, idcommit allows to choose commit to tag

git push --tags # To push tags to remote origin
</source>

To remove a tag:
<source lang="bash">
git tag -d "x.y.z_YYYYMMDD"
git push remoteentryname :x.y.z_YYYYMMDD # To validate delete on remote origin
</source>

=Creating a new branch=
With GIT Command Line Interface:

Create a clone (see previously) of the branch from where you want to create another branch, then go into directory and launch command:
<source lang="bash">
git branch x.y
git push origin x.y
</source>

With Eclipse:

Create a clone (see previously) of the branch from where you want to create another branch, with a checkout done. The go into view git. Choose branches, remote tracking and select start branch.
Right click and choose "Create branch".
Then make a push to create branch remotely.
Then go into "Remotes - origins" and edit the entries to pull and push onto new branch.
It may also be required to edit the .git/config file to have project linked by default onto new branch.

=Deleting a branch=
With GIT Command Line Interface:

Do a push on branch but add : before name of branch:
<source lang="bash">
git push remoteentryname :branchnametodelete
</source>

=Merging a maintenance branch x.x into dev branch=
With Eclipse:

*Go onto the root directory of project with a checkout of the dev branch.
*Check fetch setup to be sure, this repository contains both information of dev branch and version x.x you want to merge.
*Right click onto root directory and choose "Team - Merge". Select "x.x". Click onto "Merge options - Commit", because we want to commit merged branch if there is no conflicts.
*Once merge is done, check everything is ok.
*Commit and push.

=Pushing a branch onto another Git server=
You may want to synchronize another GIT server.
To synchronize push to another server, this is how to proceed.
With Eclipse:

*Go onto Git clone view and add a remote with a name, choose "Configure push" and enter URL. For example, for name "sourceforge" and URL "ssh://yoursourceforgelogin@git.code.sf.net/p/dolibarr/code"
*Just validate, a first push will be done automatically.
*To force sync, run

<source lang="bash">
git push sourceforge develop
git push --tags sourceforge develop
</source>

=Statistics=
With GIT Command Line interface:

To count number of changes developers have made between a version x and y:

*First, search commit id of tags you want to compare

To find id_start (common commit id between 2 versions/tags)
<source lang="bash">
git merge-base refs/tags/3.3.0 origin/3.4
or
git merge-base 3.7 origin/develop
</source>
To find id_end, choose among
<source lang="bash">
git show-ref
</source>
Choose a value for id_start and id_end
Note: id_end can be HEAD.

*Then run git log to have list of all changes from last common commit to last commit

<source lang="bash">
git log id_start..id_end
</source>

*To get total number of added/deleted lines:

<source lang="bash">
git log --ancestry-path --numstat --pretty="%H" id_start..id_end | awk 'NF==3 {plus+=$1; minus+=$2} END {printf("+%d, -%d\n", plus, minus)}'
</source>

To count number of changes finally between a version x and y (it differs from previous count because in previous count, a change can be done 2 times at two different moment to change differently. With second method, you count changes finally found if changes were ok at first try).

*Use same method than previously but instead of running git log, run git diff.

<source lang="bash">
git diff -b -M --numstat --pretty="%H" id_start..id_end | awk 'NF==3 {plus+=$1; minus+=$2} END {printf("+%d, -%d\n", plus, minus)}'
</source>

More information in GIT usage is available [http://wiki.eclipse.org/EGit/User_Guide here].
[[Category:Development]]

FAQ Get, update GIT Projekt Quellen

2022-09-23T15:10:10Z

Speaking services:

[[en:FAQ_Get,_update_GIT_Projekt_Quellen]]
[[fr:FAQ_Récupérer,_mettre_à_jour_les_sources_GIT_du_projet]]
[[es:FAQ_Recuperar,_actualizar_GIT_fuentes_del_proyecto]]


[[Category:FAQ DE]]
Hier finden Sie Informationen darüber, wie Sie die Quellen des Dolibarr-Projekts erhalten können.
Es werden mehrere Methoden beschrieben, aber wir empfehlen, die auf GitHub basierende Methode zu verwenden.

 

=Get last version of sources by tgz download=
This method can be used by non technical users.
It allows you to get sources of main development branch (called HEAD) by just downloading a file: This operation consist to get last version of Dolibarr files that are packaged each night into a tgz file. File is available with link:

{{LinkLastSnapshot}}

New files overwrite old ones.
The inconvenient of this method is that you must download and uncompress package each time you want to get updates.

Developers should not use this method to get sources but the next one.

=Get last version of sources using a GIT anonymous access=
You can use this method if you don't have any GIT access. With this method, you won't be able to submit any changes, so, if you are a developer, it is recommended to create a GitHub account and use the next method instead of this one.

==Prerequisite==

*With Eclipse IDE

First you must have a working install of Eclipse. '''EGit''' plugin must also have been installed.
For this, use the '''Find And Install process''' into Eclipse menu, add the GIT update URL:
https://download.eclipse.org/egit/updates
Then choose to install '''EGit''' (No need to choose JGit)

*With the GIT Command Line Client Interface

You need to install GIT client (GIT command line tool with Linux installed with "sudo apt-get install git", or the GIT client for Windows found at https://git-scm.com/download/win).

==Clone process==
First, enter value of the repository with reference sources into your GIT client tool.

*With Eclipse, go into perspective GIT, click onto button "Clone GIT repository". Enter GIT URL of project to get.

GIT Url for Dolibarr official source is:
<source lang="ini">
git://github.com/Dolibarr/dolibarr.git (read only)
or if you created a fork of dolibarr github from github web interface
git@github.com:yourgitaccount/dolibarr.git (read and write access)
</source>
Your Eclipse GIT client will ask you to choose the branches you are interested in. Branches not selected now could be selected later by doing a "Fetch" from the "Remotes" view, but try to choose only the branch you need. This will save you time and problems later.

Note: if you are behind a firewall, you must set Eclipse proxy credentials into Eclipse menu Windows - Preferences - General - Network connection and use the alternative URL:
<source lang="ini">
https://gitlogin:gitpassword@github.com/yourgitaccount/dolibarr.git
</source>

*With GIT on Command Line Interface:

First setup your git client:
<source lang="bash">
git config --global user.name "Your Name"
git config --global user.email "user@domain.com"
git config --list
</source>
Then clone repository locally:
<source lang="bash">
git://github.com/Dolibarr/dolibarr.git (read only)
or if you created a fork of dolibarr github from github web interface
git@github.com:yourgitaccount/dolibarr.git (read and write access)
</source>

Note: if you are behind a firewall, you must set your porxy information and use the alternative https URL:
<source lang="bash">
git config --global http.proxy http://proxyuser:proxypass@proxyserver:proxyport
git clone https://gitlogin:gitpassword@github.com/yourgitaccount/dolibarr.git dolibarr
</source>

Once this step is validated, your GIT client will download all files from remote GIT server. This may last several seconds or minutes.

Once download is finished, you must choose which branch to us to work on.

*With GIT on Command Line Interface;

<source lang="bash">
git checkout develop
git checkout x.y
</source>
This will create local branch and make checkout automatically.

*With Eclipse, right click on "Branches - Remotes - The branch you want to duplicate locally".

Choose "Create Branch" (and check the box "Checkout"). This will duplicate content of branch to work on it locally and will refresh your "Working Directory" to work on this branch.

Create Eclipse project:

If using Eclipse, once your branch is created locally, create a PHP project from assistant by choosing "'''Create from existing project'''" and select directory that is your GIT local repository (Do not choose to create a PHP project from scratch).
Then right click on project from your Eclipse workspace and Choose "'''Team - Share'''". Select GIT and click on option "'''Use or create repository in parent folder of project'''".
An alternate method is File->Import, Git->Project from Git, Select the Git repository and Next, Use New project Wizard -> Php project, enter the folder of you GIT local repository.

Then, you can setup Eclipse to avoid it to scan all project files for its build tools (Outline scanner, TODO scanner, syntax scanner...). This will avoid Eclipse to be too slow. For this, right click on project, choose Build Path and setup it like into following screenshot.

[[File:Eclipse php build path.png|240px]]

=Get last version of sources using a GitHub user access=
==Prerequisite==

*With Eclipse IDE

You must before create an account on GitHub (https://github.com/) and upload a public RSA or DSA certificate into your account profile.

Then, you must have a working install of Eclipse. '''EGit''' plugin must also have been installed.
For this, use the '''Find And Install process''' into Eclipse menu, add the GIT update URL:
https://download.eclipse.org/egit/updates
Then choose to install '''EGit'''.

*With the GIT Command Line Client Interface:

You must before create an account on GitHub (https://github.com/) and upload a public RSA or DSA certificate into your account profile.

Then, you need to install GIT client (GIT command line tool with Linux installed with "sudo apt-get install git", or the GIT client for Windows found at https://git-scm.com/download/win).

==Fork process==
Login to Github, with login you created in previous step. Then go onto page

https://github.com/Dolibarr/dolibarr

And click on button "Fork".

This will create a copy (a fork) of project into your own github area. Because you will be the owner of this fork, you will have all permissions on it to be used in next steps.

==Clone process==
Then process is same as getting sources with anonymous access.

URL to use for GIT clone is same:
<source lang="ini">
git@github.com:YourGitHubLogin/dolibarr.git
</source>

Note that a HTTPS URL is also available but it's sometimes offline (so prefer using first one, link with HTTPS is required only if you are behind a firewall):

<source lang="ini">
https://yourgithublogin@github.com/Dolibarr/dolibarr.git
</source>

=Update your repository=
To update your local workspace:

*With Eclipse IDE:

right click on Eclipse project and select "Pull".

If you made some changes into your Eclipse workspace on files that were changed into the GIT remote reference, your GIT client will make a merge automatically.

*If there is conflicts, the merge will mark all conflict files as "conflict" (See later to solve this state).
*If not, you will get all new version files including all your changes.

If you already have commited some files into your local repository, your workspace will be marked as "Merged".
All you have to do is make a commit to validate your local repository as including your changes and changes made by others.

*With the GIT Command Line Client Interface:

<source lang="bash">
git pull
</source>

=Commit and publish your changes=
To see all changes you made into your working directory and waiting to be added into Git:

*With GIT Command Line Interface:

<source lang="bash">
git status
git diff subdir/filename
</source>

To add changes made into your local repository into the GIT index, then commit this index :

*With Eclipse: Right click on file or directory to commit. Select file to add/remove/update into commit.
*With GIT Command Line Interface:

<source lang="bash">
git commit -a -m "Commit text"
</source>
This will save add and changes into your local branch.

To push them on the GIT repository server,

*With Eclipse: right click on project and choose "'''Team - Push to Upstream'''".
*With GIT Command Line Interface:

<source lang="bash">
git push
</source>

To cancel a commit:

*With GIT Command Line Interface, if commit was not already pushed:

<source lang="bash">
git reset --soft HEAD~1
</source>

*With GIT Command Line Interface, if commit was already pushed:

<source lang="bash">
git revert IdCommit or git revert HEAD (for last commit)
</source>

To merge changes done into your forked GIT instance into official Dolibarr instance:

*Go into GitHub web interface of your forked Git instance.
*Click on small button "Create a Pull request".
*Choose commit you request inclusion and validate.

=Ask official project to include your changes=
Once you pushed one or several commit toward your distant fork area on github, you can ask the Dolibarr core team to include it into official project.
For this, follow this tutorial: https://help.github.com/articles/creating-a-pull-request/

=Add an external commit into current repository=
Some developers may work and do commit into their own Git repository after forking the project. If you are interesting into getting this changes, you can import them with the following steps.

You need both Eclipse and GIT Command Line interface to achieve this:

*First, go into GIT setup view and right click on "'''Remotes'''" of your Eclipse Git working space and choose "'''Create a remote...'''"
*Type name or remote fork the developer has create (in most cases, it's developer Git login). For example: "'''thedevlogin'''". Choose also "'''Configure Fetch'''".
*Type URI of Git repository of developer. For example: '''git://github.com/thedevlogin/dolibarr.git'''. Also add a refspec value to declare the branch you want to get. For example: '''refs/heads/master:refs/remotes/thedevlogin/master'''. Click "'''Save and Fetch'''". A new entry will be added into "Remote Tracking" making possible to read/get commits done into this branch.

Now, go on command line of your git repository (in most cases on Linux, it's '''/home/yourlogin/git/yourdolibarr''') and type the git cherry-pick command:
<source lang="bash">
git cherry-pick -x commitid
</source>
where commitid is value of commit id you want to get.

Once this is done, go back to Eclipse and make a refresh on project. You will see modified files appears with decorators (with conflicts if there is).

It the cherry-pick fails because of conflicts, you can cancel the cherry-pick try with
<source lang="bash">
git cherry-pick --abort
</source>

=Solving a conflict=
If a file has been marked as "conflict" after a Pull, open the file to edit it.
Find string "<<<<<<<<<<", you will see part of code that is conflict between "<<<<<<<<<" and ">>>>>>>>". Edit manually code lines and remove "<<<<<<<<" and ">>>>>>>".

Then, right click on file and select "Add".

If you prefer to forget completely all changes you made into all files (so to restore you workspace with content of remote repository), you can make a hard reset:

*With Eclipse: Right click on project top line and select "'''Reset'''" then "'''Hard'''" then "'''Reference - HEAD'''".
*With GIT Command Line Interface: You can achieve this with command

<source lang="bash">
git reset --hard HEAD
</source>
To reset changes you commited but not pushed to origin
<source lang="bash">
git reset --hard origin/develop
</source>

=Tagging sources=
With GIT Command Line Interface:

To add a tag to a current version:
<source lang="bash">
git tag -a -m "Release|Maintenance release x.y.z" "x.y.z"
or
git tag -a -f -m "Beta x.y.betai" "x.y.betai_YYYYMMDD" idcommit # -f force if an existing tag already exists, idcommit allows to choose commit to tag

git push --tags # To push tags to remote origin
</source>

To remove a tag:
<source lang="bash">
git tag -d "x.y.z_YYYYMMDD"
git push remoteentryname :x.y.z_YYYYMMDD # To validate delete on remote origin
</source>

=Creating a new branch=
With GIT Command Line Interface:

Create a clone (see previously) of the branch from where you want to create another branch, then go into directory and launch command:
<source lang="bash">
git branch x.y
git push origin x.y
</source>

With Eclipse:

Create a clone (see previously) of the branch from where you want to create another branch, with a checkout done. The go into view git. Choose branches, remote tracking and select start branch.
Right click and choose "Create branch".
Then make a push to create branch remotely.
Then go into "Remotes - origins" and edit the entries to pull and push onto new branch.
It may also be required to edit the .git/config file to have project linked by default onto new branch.

=Deleting a branch=
With GIT Command Line Interface:

Do a push on branch but add : before name of branch:
<source lang="bash">
git push remoteentryname :branchnametodelete
</source>

=Merging a maintenance branch x.x into dev branch=
With Eclipse:

*Go onto the root directory of project with a checkout of the dev branch.
*Check fetch setup to be sure, this repository contains both information of dev branch and version x.x you want to merge.
*Right click onto root directory and choose "Team - Merge". Select "x.x". Click onto "Merge options - Commit", because we want to commit merged branch if there is no conflicts.
*Once merge is done, check everything is ok.
*Commit and push.

=Pushing a branch onto another Git server=
You may want to synchronize another GIT server.
To synchronize push to another server, this is how to proceed.
With Eclipse:

*Go onto Git clone view and add a remote with a name, choose "Configure push" and enter URL. For example, for name "sourceforge" and URL "ssh://yoursourceforgelogin@git.code.sf.net/p/dolibarr/code"
*Just validate, a first push will be done automatically.
*To force sync, run

<source lang="bash">
git push sourceforge develop
git push --tags sourceforge develop
</source>

=Statistics=
With GIT Command Line interface:

To count number of changes developers have made between a version x and y:

*First, search commit id of tags you want to compare

To find id_start (common commit id between 2 versions/tags)
<source lang="bash">
git merge-base refs/tags/3.3.0 origin/3.4
or
git merge-base 3.7 origin/develop
</source>
To find id_end, choose among
<source lang="bash">
git show-ref
</source>
Choose a value for id_start and id_end
Note: id_end can be HEAD.

*Then run git log to have list of all changes from last common commit to last commit

<source lang="bash">
git log id_start..id_end
</source>

*To get total number of added/deleted lines:

<source lang="bash">
git log --ancestry-path --numstat --pretty="%H" id_start..id_end | awk 'NF==3 {plus+=$1; minus+=$2} END {printf("+%d, -%d\n", plus, minus)}'
</source>

To count number of changes finally between a version x and y (it differs from previous count because in previous count, a change can be done 2 times at two different moment to change differently. With second method, you count changes finally found if changes were ok at first try).

*Use same method than previously but instead of running git log, run git diff.

<source lang="bash">
git diff -b -M --numstat --pretty="%H" id_start..id_end | awk 'NF==3 {plus+=$1; minus+=$2} END {printf("+%d, -%d\n", plus, minus)}'
</source>

More information in GIT usage is available [http://wiki.eclipse.org/EGit/User_Guide here].
[[Category:Development]]

FAQ Get, update GIT Projekt Quellen

2022-09-23T15:09:46Z

Speaking services:

[[en:FAQ_Get,_update_GIT_Projekt_Quellen]]
[[fr:FAQ_Récupérer,_mettre_à_jour_les_sources_GIT_du_projet]]
[[es:FAQ_Recuperar,_actualizar_GIT_fuentes_del_proyecto]]


[[Category:FAQ DE]]
{{TemplateDocDevDE}}
Hier finden Sie Informationen darüber, wie Sie die Quellen des Dolibarr-Projekts erhalten können.
Es werden mehrere Methoden beschrieben, aber wir empfehlen, die auf GitHub basierende Methode zu verwenden.

 

=Get last version of sources by tgz download=
This method can be used by non technical users.
It allows you to get sources of main development branch (called HEAD) by just downloading a file: This operation consist to get last version of Dolibarr files that are packaged each night into a tgz file. File is available with link:

{{LinkLastSnapshot}}

New files overwrite old ones.
The inconvenient of this method is that you must download and uncompress package each time you want to get updates.

Developers should not use this method to get sources but the next one.

=Get last version of sources using a GIT anonymous access=
You can use this method if you don't have any GIT access. With this method, you won't be able to submit any changes, so, if you are a developer, it is recommended to create a GitHub account and use the next method instead of this one.

==Prerequisite==

*With Eclipse IDE

First you must have a working install of Eclipse. '''EGit''' plugin must also have been installed.
For this, use the '''Find And Install process''' into Eclipse menu, add the GIT update URL:
https://download.eclipse.org/egit/updates
Then choose to install '''EGit''' (No need to choose JGit)

*With the GIT Command Line Client Interface

You need to install GIT client (GIT command line tool with Linux installed with "sudo apt-get install git", or the GIT client for Windows found at https://git-scm.com/download/win).

==Clone process==
First, enter value of the repository with reference sources into your GIT client tool.

*With Eclipse, go into perspective GIT, click onto button "Clone GIT repository". Enter GIT URL of project to get.

GIT Url for Dolibarr official source is:
<source lang="ini">
git://github.com/Dolibarr/dolibarr.git (read only)
or if you created a fork of dolibarr github from github web interface
git@github.com:yourgitaccount/dolibarr.git (read and write access)
</source>
Your Eclipse GIT client will ask you to choose the branches you are interested in. Branches not selected now could be selected later by doing a "Fetch" from the "Remotes" view, but try to choose only the branch you need. This will save you time and problems later.

Note: if you are behind a firewall, you must set Eclipse proxy credentials into Eclipse menu Windows - Preferences - General - Network connection and use the alternative URL:
<source lang="ini">
https://gitlogin:gitpassword@github.com/yourgitaccount/dolibarr.git
</source>

*With GIT on Command Line Interface:

First setup your git client:
<source lang="bash">
git config --global user.name "Your Name"
git config --global user.email "user@domain.com"
git config --list
</source>
Then clone repository locally:
<source lang="bash">
git://github.com/Dolibarr/dolibarr.git (read only)
or if you created a fork of dolibarr github from github web interface
git@github.com:yourgitaccount/dolibarr.git (read and write access)
</source>

Note: if you are behind a firewall, you must set your porxy information and use the alternative https URL:
<source lang="bash">
git config --global http.proxy http://proxyuser:proxypass@proxyserver:proxyport
git clone https://gitlogin:gitpassword@github.com/yourgitaccount/dolibarr.git dolibarr
</source>

Once this step is validated, your GIT client will download all files from remote GIT server. This may last several seconds or minutes.

Once download is finished, you must choose which branch to us to work on.

*With GIT on Command Line Interface;

<source lang="bash">
git checkout develop
git checkout x.y
</source>
This will create local branch and make checkout automatically.

*With Eclipse, right click on "Branches - Remotes - The branch you want to duplicate locally".

Choose "Create Branch" (and check the box "Checkout"). This will duplicate content of branch to work on it locally and will refresh your "Working Directory" to work on this branch.

Create Eclipse project:

If using Eclipse, once your branch is created locally, create a PHP project from assistant by choosing "'''Create from existing project'''" and select directory that is your GIT local repository (Do not choose to create a PHP project from scratch).
Then right click on project from your Eclipse workspace and Choose "'''Team - Share'''". Select GIT and click on option "'''Use or create repository in parent folder of project'''".
An alternate method is File->Import, Git->Project from Git, Select the Git repository and Next, Use New project Wizard -> Php project, enter the folder of you GIT local repository.

Then, you can setup Eclipse to avoid it to scan all project files for its build tools (Outline scanner, TODO scanner, syntax scanner...). This will avoid Eclipse to be too slow. For this, right click on project, choose Build Path and setup it like into following screenshot.

[[File:Eclipse php build path.png|240px]]

=Get last version of sources using a GitHub user access=
==Prerequisite==

*With Eclipse IDE

You must before create an account on GitHub (https://github.com/) and upload a public RSA or DSA certificate into your account profile.

Then, you must have a working install of Eclipse. '''EGit''' plugin must also have been installed.
For this, use the '''Find And Install process''' into Eclipse menu, add the GIT update URL:
https://download.eclipse.org/egit/updates
Then choose to install '''EGit'''.

*With the GIT Command Line Client Interface:

You must before create an account on GitHub (https://github.com/) and upload a public RSA or DSA certificate into your account profile.

Then, you need to install GIT client (GIT command line tool with Linux installed with "sudo apt-get install git", or the GIT client for Windows found at https://git-scm.com/download/win).

==Fork process==
Login to Github, with login you created in previous step. Then go onto page

https://github.com/Dolibarr/dolibarr

And click on button "Fork".

This will create a copy (a fork) of project into your own github area. Because you will be the owner of this fork, you will have all permissions on it to be used in next steps.

==Clone process==
Then process is same as getting sources with anonymous access.

URL to use for GIT clone is same:
<source lang="ini">
git@github.com:YourGitHubLogin/dolibarr.git
</source>

Note that a HTTPS URL is also available but it's sometimes offline (so prefer using first one, link with HTTPS is required only if you are behind a firewall):

<source lang="ini">
https://yourgithublogin@github.com/Dolibarr/dolibarr.git
</source>

=Update your repository=
To update your local workspace:

*With Eclipse IDE:

right click on Eclipse project and select "Pull".

If you made some changes into your Eclipse workspace on files that were changed into the GIT remote reference, your GIT client will make a merge automatically.

*If there is conflicts, the merge will mark all conflict files as "conflict" (See later to solve this state).
*If not, you will get all new version files including all your changes.

If you already have commited some files into your local repository, your workspace will be marked as "Merged".
All you have to do is make a commit to validate your local repository as including your changes and changes made by others.

*With the GIT Command Line Client Interface:

<source lang="bash">
git pull
</source>

=Commit and publish your changes=
To see all changes you made into your working directory and waiting to be added into Git:

*With GIT Command Line Interface:

<source lang="bash">
git status
git diff subdir/filename
</source>

To add changes made into your local repository into the GIT index, then commit this index :

*With Eclipse: Right click on file or directory to commit. Select file to add/remove/update into commit.
*With GIT Command Line Interface:

<source lang="bash">
git commit -a -m "Commit text"
</source>
This will save add and changes into your local branch.

To push them on the GIT repository server,

*With Eclipse: right click on project and choose "'''Team - Push to Upstream'''".
*With GIT Command Line Interface:

<source lang="bash">
git push
</source>

To cancel a commit:

*With GIT Command Line Interface, if commit was not already pushed:

<source lang="bash">
git reset --soft HEAD~1
</source>

*With GIT Command Line Interface, if commit was already pushed:

<source lang="bash">
git revert IdCommit or git revert HEAD (for last commit)
</source>

To merge changes done into your forked GIT instance into official Dolibarr instance:

*Go into GitHub web interface of your forked Git instance.
*Click on small button "Create a Pull request".
*Choose commit you request inclusion and validate.

=Ask official project to include your changes=
Once you pushed one or several commit toward your distant fork area on github, you can ask the Dolibarr core team to include it into official project.
For this, follow this tutorial: https://help.github.com/articles/creating-a-pull-request/

=Add an external commit into current repository=
Some developers may work and do commit into their own Git repository after forking the project. If you are interesting into getting this changes, you can import them with the following steps.

You need both Eclipse and GIT Command Line interface to achieve this:

*First, go into GIT setup view and right click on "'''Remotes'''" of your Eclipse Git working space and choose "'''Create a remote...'''"
*Type name or remote fork the developer has create (in most cases, it's developer Git login). For example: "'''thedevlogin'''". Choose also "'''Configure Fetch'''".
*Type URI of Git repository of developer. For example: '''git://github.com/thedevlogin/dolibarr.git'''. Also add a refspec value to declare the branch you want to get. For example: '''refs/heads/master:refs/remotes/thedevlogin/master'''. Click "'''Save and Fetch'''". A new entry will be added into "Remote Tracking" making possible to read/get commits done into this branch.

Now, go on command line of your git repository (in most cases on Linux, it's '''/home/yourlogin/git/yourdolibarr''') and type the git cherry-pick command:
<source lang="bash">
git cherry-pick -x commitid
</source>
where commitid is value of commit id you want to get.

Once this is done, go back to Eclipse and make a refresh on project. You will see modified files appears with decorators (with conflicts if there is).

It the cherry-pick fails because of conflicts, you can cancel the cherry-pick try with
<source lang="bash">
git cherry-pick --abort
</source>

=Solving a conflict=
If a file has been marked as "conflict" after a Pull, open the file to edit it.
Find string "<<<<<<<<<<", you will see part of code that is conflict between "<<<<<<<<<" and ">>>>>>>>". Edit manually code lines and remove "<<<<<<<<" and ">>>>>>>".

Then, right click on file and select "Add".

If you prefer to forget completely all changes you made into all files (so to restore you workspace with content of remote repository), you can make a hard reset:

*With Eclipse: Right click on project top line and select "'''Reset'''" then "'''Hard'''" then "'''Reference - HEAD'''".
*With GIT Command Line Interface: You can achieve this with command

<source lang="bash">
git reset --hard HEAD
</source>
To reset changes you commited but not pushed to origin
<source lang="bash">
git reset --hard origin/develop
</source>

=Tagging sources=
With GIT Command Line Interface:

To add a tag to a current version:
<source lang="bash">
git tag -a -m "Release|Maintenance release x.y.z" "x.y.z"
or
git tag -a -f -m "Beta x.y.betai" "x.y.betai_YYYYMMDD" idcommit # -f force if an existing tag already exists, idcommit allows to choose commit to tag

git push --tags # To push tags to remote origin
</source>

To remove a tag:
<source lang="bash">
git tag -d "x.y.z_YYYYMMDD"
git push remoteentryname :x.y.z_YYYYMMDD # To validate delete on remote origin
</source>

=Creating a new branch=
With GIT Command Line Interface:

Create a clone (see previously) of the branch from where you want to create another branch, then go into directory and launch command:
<source lang="bash">
git branch x.y
git push origin x.y
</source>

With Eclipse:

Create a clone (see previously) of the branch from where you want to create another branch, with a checkout done. The go into view git. Choose branches, remote tracking and select start branch.
Right click and choose "Create branch".
Then make a push to create branch remotely.
Then go into "Remotes - origins" and edit the entries to pull and push onto new branch.
It may also be required to edit the .git/config file to have project linked by default onto new branch.

=Deleting a branch=
With GIT Command Line Interface:

Do a push on branch but add : before name of branch:
<source lang="bash">
git push remoteentryname :branchnametodelete
</source>

=Merging a maintenance branch x.x into dev branch=
With Eclipse:

*Go onto the root directory of project with a checkout of the dev branch.
*Check fetch setup to be sure, this repository contains both information of dev branch and version x.x you want to merge.
*Right click onto root directory and choose "Team - Merge". Select "x.x". Click onto "Merge options - Commit", because we want to commit merged branch if there is no conflicts.
*Once merge is done, check everything is ok.
*Commit and push.

=Pushing a branch onto another Git server=
You may want to synchronize another GIT server.
To synchronize push to another server, this is how to proceed.
With Eclipse:

*Go onto Git clone view and add a remote with a name, choose "Configure push" and enter URL. For example, for name "sourceforge" and URL "ssh://yoursourceforgelogin@git.code.sf.net/p/dolibarr/code"
*Just validate, a first push will be done automatically.
*To force sync, run

<source lang="bash">
git push sourceforge develop
git push --tags sourceforge develop
</source>

=Statistics=
With GIT Command Line interface:

To count number of changes developers have made between a version x and y:

*First, search commit id of tags you want to compare

To find id_start (common commit id between 2 versions/tags)
<source lang="bash">
git merge-base refs/tags/3.3.0 origin/3.4
or
git merge-base 3.7 origin/develop
</source>
To find id_end, choose among
<source lang="bash">
git show-ref
</source>
Choose a value for id_start and id_end
Note: id_end can be HEAD.

*Then run git log to have list of all changes from last common commit to last commit

<source lang="bash">
git log id_start..id_end
</source>

*To get total number of added/deleted lines:

<source lang="bash">
git log --ancestry-path --numstat --pretty="%H" id_start..id_end | awk 'NF==3 {plus+=$1; minus+=$2} END {printf("+%d, -%d\n", plus, minus)}'
</source>

To count number of changes finally between a version x and y (it differs from previous count because in previous count, a change can be done 2 times at two different moment to change differently. With second method, you count changes finally found if changes were ok at first try).

*Use same method than previously but instead of running git log, run git diff.

<source lang="bash">
git diff -b -M --numstat --pretty="%H" id_start..id_end | awk 'NF==3 {plus+=$1; minus+=$2} END {printf("+%d, -%d\n", plus, minus)}'
</source>

More information in GIT usage is available [http://wiki.eclipse.org/EGit/User_Guide here].
[[Category:Development]]

FAQ Get, update GIT Projekt Quellen

2022-09-23T15:07:54Z

Speaking services:

[[fr:FAQ_Récupérer,_mettre_à_jour_les_sources_GIT_du_projet]]
[[es:FAQ_Recuperar,_actualizar_GIT_fuentes_del_proyecto]]
[[de:FAQ_Get,_update_GIT_Projekt_Quellen]]


[[Category:FAQ DE]]
{{TemplateDocDevEn}}
This is information on how you can get sources of Dolibarr project.
Several methods are described, but we recommand using the one based on GitHub.

 

=Get last version of sources by tgz download=
This method can be used by non technical users.
It allows you to get sources of main development branch (called HEAD) by just downloading a file: This operation consist to get last version of Dolibarr files that are packaged each night into a tgz file. File is available with link:

{{LinkLastSnapshot}}

New files overwrite old ones.
The inconvenient of this method is that you must download and uncompress package each time you want to get updates.

Developers should not use this method to get sources but the next one.

=Get last version of sources using a GIT anonymous access=
You can use this method if you don't have any GIT access. With this method, you won't be able to submit any changes, so, if you are a developer, it is recommended to create a GitHub account and use the next method instead of this one.

==Prerequisite==

*With Eclipse IDE

First you must have a working install of Eclipse. '''EGit''' plugin must also have been installed.
For this, use the '''Find And Install process''' into Eclipse menu, add the GIT update URL:
https://download.eclipse.org/egit/updates
Then choose to install '''EGit''' (No need to choose JGit)

*With the GIT Command Line Client Interface

You need to install GIT client (GIT command line tool with Linux installed with "sudo apt-get install git", or the GIT client for Windows found at https://git-scm.com/download/win).

==Clone process==
First, enter value of the repository with reference sources into your GIT client tool.

*With Eclipse, go into perspective GIT, click onto button "Clone GIT repository". Enter GIT URL of project to get.

GIT Url for Dolibarr official source is:
<source lang="ini">
git://github.com/Dolibarr/dolibarr.git (read only)
or if you created a fork of dolibarr github from github web interface
git@github.com:yourgitaccount/dolibarr.git (read and write access)
</source>
Your Eclipse GIT client will ask you to choose the branches you are interested in. Branches not selected now could be selected later by doing a "Fetch" from the "Remotes" view, but try to choose only the branch you need. This will save you time and problems later.

Note: if you are behind a firewall, you must set Eclipse proxy credentials into Eclipse menu Windows - Preferences - General - Network connection and use the alternative URL:
<source lang="ini">
https://gitlogin:gitpassword@github.com/yourgitaccount/dolibarr.git
</source>

*With GIT on Command Line Interface:

First setup your git client:
<source lang="bash">
git config --global user.name "Your Name"
git config --global user.email "user@domain.com"
git config --list
</source>
Then clone repository locally:
<source lang="bash">
git://github.com/Dolibarr/dolibarr.git (read only)
or if you created a fork of dolibarr github from github web interface
git@github.com:yourgitaccount/dolibarr.git (read and write access)
</source>

Note: if you are behind a firewall, you must set your porxy information and use the alternative https URL:
<source lang="bash">
git config --global http.proxy http://proxyuser:proxypass@proxyserver:proxyport
git clone https://gitlogin:gitpassword@github.com/yourgitaccount/dolibarr.git dolibarr
</source>

Once this step is validated, your GIT client will download all files from remote GIT server. This may last several seconds or minutes.

Once download is finished, you must choose which branch to us to work on.

*With GIT on Command Line Interface;

<source lang="bash">
git checkout develop
git checkout x.y
</source>
This will create local branch and make checkout automatically.

*With Eclipse, right click on "Branches - Remotes - The branch you want to duplicate locally".

Choose "Create Branch" (and check the box "Checkout"). This will duplicate content of branch to work on it locally and will refresh your "Working Directory" to work on this branch.

Create Eclipse project:

If using Eclipse, once your branch is created locally, create a PHP project from assistant by choosing "'''Create from existing project'''" and select directory that is your GIT local repository (Do not choose to create a PHP project from scratch).
Then right click on project from your Eclipse workspace and Choose "'''Team - Share'''". Select GIT and click on option "'''Use or create repository in parent folder of project'''".
An alternate method is File->Import, Git->Project from Git, Select the Git repository and Next, Use New project Wizard -> Php project, enter the folder of you GIT local repository.

Then, you can setup Eclipse to avoid it to scan all project files for its build tools (Outline scanner, TODO scanner, syntax scanner...). This will avoid Eclipse to be too slow. For this, right click on project, choose Build Path and setup it like into following screenshot.

[[File:Eclipse php build path.png|240px]]

=Get last version of sources using a GitHub user access=
==Prerequisite==

*With Eclipse IDE

You must before create an account on GitHub (https://github.com/) and upload a public RSA or DSA certificate into your account profile.

Then, you must have a working install of Eclipse. '''EGit''' plugin must also have been installed.
For this, use the '''Find And Install process''' into Eclipse menu, add the GIT update URL:
https://download.eclipse.org/egit/updates
Then choose to install '''EGit'''.

*With the GIT Command Line Client Interface:

You must before create an account on GitHub (https://github.com/) and upload a public RSA or DSA certificate into your account profile.

Then, you need to install GIT client (GIT command line tool with Linux installed with "sudo apt-get install git", or the GIT client for Windows found at https://git-scm.com/download/win).

==Fork process==
Login to Github, with login you created in previous step. Then go onto page

https://github.com/Dolibarr/dolibarr

And click on button "Fork".

This will create a copy (a fork) of project into your own github area. Because you will be the owner of this fork, you will have all permissions on it to be used in next steps.

==Clone process==
Then process is same as getting sources with anonymous access.

URL to use for GIT clone is same:
<source lang="ini">
git@github.com:YourGitHubLogin/dolibarr.git
</source>

Note that a HTTPS URL is also available but it's sometimes offline (so prefer using first one, link with HTTPS is required only if you are behind a firewall):

<source lang="ini">
https://yourgithublogin@github.com/Dolibarr/dolibarr.git
</source>

=Update your repository=
To update your local workspace:

*With Eclipse IDE:

right click on Eclipse project and select "Pull".

If you made some changes into your Eclipse workspace on files that were changed into the GIT remote reference, your GIT client will make a merge automatically.

*If there is conflicts, the merge will mark all conflict files as "conflict" (See later to solve this state).
*If not, you will get all new version files including all your changes.

If you already have commited some files into your local repository, your workspace will be marked as "Merged".
All you have to do is make a commit to validate your local repository as including your changes and changes made by others.

*With the GIT Command Line Client Interface:

<source lang="bash">
git pull
</source>

=Commit and publish your changes=
To see all changes you made into your working directory and waiting to be added into Git:

*With GIT Command Line Interface:

<source lang="bash">
git status
git diff subdir/filename
</source>

To add changes made into your local repository into the GIT index, then commit this index :

*With Eclipse: Right click on file or directory to commit. Select file to add/remove/update into commit.
*With GIT Command Line Interface:

<source lang="bash">
git commit -a -m "Commit text"
</source>
This will save add and changes into your local branch.

To push them on the GIT repository server,

*With Eclipse: right click on project and choose "'''Team - Push to Upstream'''".
*With GIT Command Line Interface:

<source lang="bash">
git push
</source>

To cancel a commit:

*With GIT Command Line Interface, if commit was not already pushed:

<source lang="bash">
git reset --soft HEAD~1
</source>

*With GIT Command Line Interface, if commit was already pushed:

<source lang="bash">
git revert IdCommit or git revert HEAD (for last commit)
</source>

To merge changes done into your forked GIT instance into official Dolibarr instance:

*Go into GitHub web interface of your forked Git instance.
*Click on small button "Create a Pull request".
*Choose commit you request inclusion and validate.

=Ask official project to include your changes=
Once you pushed one or several commit toward your distant fork area on github, you can ask the Dolibarr core team to include it into official project.
For this, follow this tutorial: https://help.github.com/articles/creating-a-pull-request/

=Add an external commit into current repository=
Some developers may work and do commit into their own Git repository after forking the project. If you are interesting into getting this changes, you can import them with the following steps.

You need both Eclipse and GIT Command Line interface to achieve this:

*First, go into GIT setup view and right click on "'''Remotes'''" of your Eclipse Git working space and choose "'''Create a remote...'''"
*Type name or remote fork the developer has create (in most cases, it's developer Git login). For example: "'''thedevlogin'''". Choose also "'''Configure Fetch'''".
*Type URI of Git repository of developer. For example: '''git://github.com/thedevlogin/dolibarr.git'''. Also add a refspec value to declare the branch you want to get. For example: '''refs/heads/master:refs/remotes/thedevlogin/master'''. Click "'''Save and Fetch'''". A new entry will be added into "Remote Tracking" making possible to read/get commits done into this branch.

Now, go on command line of your git repository (in most cases on Linux, it's '''/home/yourlogin/git/yourdolibarr''') and type the git cherry-pick command:
<source lang="bash">
git cherry-pick -x commitid
</source>
where commitid is value of commit id you want to get.

Once this is done, go back to Eclipse and make a refresh on project. You will see modified files appears with decorators (with conflicts if there is).

It the cherry-pick fails because of conflicts, you can cancel the cherry-pick try with
<source lang="bash">
git cherry-pick --abort
</source>

=Solving a conflict=
If a file has been marked as "conflict" after a Pull, open the file to edit it.
Find string "<<<<<<<<<<", you will see part of code that is conflict between "<<<<<<<<<" and ">>>>>>>>". Edit manually code lines and remove "<<<<<<<<" and ">>>>>>>".

Then, right click on file and select "Add".

If you prefer to forget completely all changes you made into all files (so to restore you workspace with content of remote repository), you can make a hard reset:

*With Eclipse: Right click on project top line and select "'''Reset'''" then "'''Hard'''" then "'''Reference - HEAD'''".
*With GIT Command Line Interface: You can achieve this with command

<source lang="bash">
git reset --hard HEAD
</source>
To reset changes you commited but not pushed to origin
<source lang="bash">
git reset --hard origin/develop
</source>

=Tagging sources=
With GIT Command Line Interface:

To add a tag to a current version:
<source lang="bash">
git tag -a -m "Release|Maintenance release x.y.z" "x.y.z"
or
git tag -a -f -m "Beta x.y.betai" "x.y.betai_YYYYMMDD" idcommit # -f force if an existing tag already exists, idcommit allows to choose commit to tag

git push --tags # To push tags to remote origin
</source>

To remove a tag:
<source lang="bash">
git tag -d "x.y.z_YYYYMMDD"
git push remoteentryname :x.y.z_YYYYMMDD # To validate delete on remote origin
</source>

=Creating a new branch=
With GIT Command Line Interface:

Create a clone (see previously) of the branch from where you want to create another branch, then go into directory and launch command:
<source lang="bash">
git branch x.y
git push origin x.y
</source>

With Eclipse:

Create a clone (see previously) of the branch from where you want to create another branch, with a checkout done. The go into view git. Choose branches, remote tracking and select start branch.
Right click and choose "Create branch".
Then make a push to create branch remotely.
Then go into "Remotes - origins" and edit the entries to pull and push onto new branch.
It may also be required to edit the .git/config file to have project linked by default onto new branch.

=Deleting a branch=
With GIT Command Line Interface:

Do a push on branch but add : before name of branch:
<source lang="bash">
git push remoteentryname :branchnametodelete
</source>

=Merging a maintenance branch x.x into dev branch=
With Eclipse:

*Go onto the root directory of project with a checkout of the dev branch.
*Check fetch setup to be sure, this repository contains both information of dev branch and version x.x you want to merge.
*Right click onto root directory and choose "Team - Merge". Select "x.x". Click onto "Merge options - Commit", because we want to commit merged branch if there is no conflicts.
*Once merge is done, check everything is ok.
*Commit and push.

=Pushing a branch onto another Git server=
You may want to synchronize another GIT server.
To synchronize push to another server, this is how to proceed.
With Eclipse:

*Go onto Git clone view and add a remote with a name, choose "Configure push" and enter URL. For example, for name "sourceforge" and URL "ssh://yoursourceforgelogin@git.code.sf.net/p/dolibarr/code"
*Just validate, a first push will be done automatically.
*To force sync, run

<source lang="bash">
git push sourceforge develop
git push --tags sourceforge develop
</source>

=Statistics=
With GIT Command Line interface:

To count number of changes developers have made between a version x and y:

*First, search commit id of tags you want to compare

To find id_start (common commit id between 2 versions/tags)
<source lang="bash">
git merge-base refs/tags/3.3.0 origin/3.4
or
git merge-base 3.7 origin/develop
</source>
To find id_end, choose among
<source lang="bash">
git show-ref
</source>
Choose a value for id_start and id_end
Note: id_end can be HEAD.

*Then run git log to have list of all changes from last common commit to last commit

<source lang="bash">
git log id_start..id_end
</source>

*To get total number of added/deleted lines:

<source lang="bash">
git log --ancestry-path --numstat --pretty="%H" id_start..id_end | awk 'NF==3 {plus+=$1; minus+=$2} END {printf("+%d, -%d\n", plus, minus)}'
</source>

To count number of changes finally between a version x and y (it differs from previous count because in previous count, a change can be done 2 times at two different moment to change differently. With second method, you count changes finally found if changes were ok at first try).

*Use same method than previously but instead of running git log, run git diff.

<source lang="bash">
git diff -b -M --numstat --pretty="%H" id_start..id_end | awk 'NF==3 {plus+=$1; minus+=$2} END {printf("+%d, -%d\n", plus, minus)}'
</source>

More information in GIT usage is available [http://wiki.eclipse.org/EGit/User_Guide here].
[[Category:Development]]

FAQ Get, update GIT Projekt Quellen

2022-09-23T15:06:37Z

Speaking services: Created page with "Category:FAQ EN {{TemplateDocDevEn}} This is information on how you can get sources of Dolibarr project. Several methods are described, but we recommand using the one bas..."

[[Category:FAQ EN]]
{{TemplateDocDevEn}}
This is information on how you can get sources of Dolibarr project.
Several methods are described, but we recommand using the one based on GitHub.

 

=Get last version of sources by tgz download=
This method can be used by non technical users.
It allows you to get sources of main development branch (called HEAD) by just downloading a file: This operation consist to get last version of Dolibarr files that are packaged each night into a tgz file. File is available with link:

{{LinkLastSnapshot}}

New files overwrite old ones.
The inconvenient of this method is that you must download and uncompress package each time you want to get updates.

Developers should not use this method to get sources but the next one.

=Get last version of sources using a GIT anonymous access=
You can use this method if you don't have any GIT access. With this method, you won't be able to submit any changes, so, if you are a developer, it is recommended to create a GitHub account and use the next method instead of this one.

==Prerequisite==

*With Eclipse IDE

First you must have a working install of Eclipse. '''EGit''' plugin must also have been installed.
For this, use the '''Find And Install process''' into Eclipse menu, add the GIT update URL:
https://download.eclipse.org/egit/updates
Then choose to install '''EGit''' (No need to choose JGit)

*With the GIT Command Line Client Interface

You need to install GIT client (GIT command line tool with Linux installed with "sudo apt-get install git", or the GIT client for Windows found at https://git-scm.com/download/win).

==Clone process==
First, enter value of the repository with reference sources into your GIT client tool.

*With Eclipse, go into perspective GIT, click onto button "Clone GIT repository". Enter GIT URL of project to get.

GIT Url for Dolibarr official source is:
<source lang="ini">
git://github.com/Dolibarr/dolibarr.git (read only)
or if you created a fork of dolibarr github from github web interface
git@github.com:yourgitaccount/dolibarr.git (read and write access)
</source>
Your Eclipse GIT client will ask you to choose the branches you are interested in. Branches not selected now could be selected later by doing a "Fetch" from the "Remotes" view, but try to choose only the branch you need. This will save you time and problems later.

Note: if you are behind a firewall, you must set Eclipse proxy credentials into Eclipse menu Windows - Preferences - General - Network connection and use the alternative URL:
<source lang="ini">
https://gitlogin:gitpassword@github.com/yourgitaccount/dolibarr.git
</source>

*With GIT on Command Line Interface:

First setup your git client:
<source lang="bash">
git config --global user.name "Your Name"
git config --global user.email "user@domain.com"
git config --list
</source>
Then clone repository locally:
<source lang="bash">
git://github.com/Dolibarr/dolibarr.git (read only)
or if you created a fork of dolibarr github from github web interface
git@github.com:yourgitaccount/dolibarr.git (read and write access)
</source>

Note: if you are behind a firewall, you must set your porxy information and use the alternative https URL:
<source lang="bash">
git config --global http.proxy http://proxyuser:proxypass@proxyserver:proxyport
git clone https://gitlogin:gitpassword@github.com/yourgitaccount/dolibarr.git dolibarr
</source>

Once this step is validated, your GIT client will download all files from remote GIT server. This may last several seconds or minutes.

Once download is finished, you must choose which branch to us to work on.

*With GIT on Command Line Interface;

<source lang="bash">
git checkout develop
git checkout x.y
</source>
This will create local branch and make checkout automatically.

*With Eclipse, right click on "Branches - Remotes - The branch you want to duplicate locally".

Choose "Create Branch" (and check the box "Checkout"). This will duplicate content of branch to work on it locally and will refresh your "Working Directory" to work on this branch.

Create Eclipse project:

If using Eclipse, once your branch is created locally, create a PHP project from assistant by choosing "'''Create from existing project'''" and select directory that is your GIT local repository (Do not choose to create a PHP project from scratch).
Then right click on project from your Eclipse workspace and Choose "'''Team - Share'''". Select GIT and click on option "'''Use or create repository in parent folder of project'''".
An alternate method is File->Import, Git->Project from Git, Select the Git repository and Next, Use New project Wizard -> Php project, enter the folder of you GIT local repository.

Then, you can setup Eclipse to avoid it to scan all project files for its build tools (Outline scanner, TODO scanner, syntax scanner...). This will avoid Eclipse to be too slow. For this, right click on project, choose Build Path and setup it like into following screenshot.

[[File:Eclipse php build path.png|240px]]

=Get last version of sources using a GitHub user access=
==Prerequisite==

*With Eclipse IDE

You must before create an account on GitHub (https://github.com/) and upload a public RSA or DSA certificate into your account profile.

Then, you must have a working install of Eclipse. '''EGit''' plugin must also have been installed.
For this, use the '''Find And Install process''' into Eclipse menu, add the GIT update URL:
https://download.eclipse.org/egit/updates
Then choose to install '''EGit'''.

*With the GIT Command Line Client Interface:

You must before create an account on GitHub (https://github.com/) and upload a public RSA or DSA certificate into your account profile.

Then, you need to install GIT client (GIT command line tool with Linux installed with "sudo apt-get install git", or the GIT client for Windows found at https://git-scm.com/download/win).

==Fork process==
Login to Github, with login you created in previous step. Then go onto page

https://github.com/Dolibarr/dolibarr

And click on button "Fork".

This will create a copy (a fork) of project into your own github area. Because you will be the owner of this fork, you will have all permissions on it to be used in next steps.

==Clone process==
Then process is same as getting sources with anonymous access.

URL to use for GIT clone is same:
<source lang="ini">
git@github.com:YourGitHubLogin/dolibarr.git
</source>

Note that a HTTPS URL is also available but it's sometimes offline (so prefer using first one, link with HTTPS is required only if you are behind a firewall):

<source lang="ini">
https://yourgithublogin@github.com/Dolibarr/dolibarr.git
</source>

=Update your repository=
To update your local workspace:

*With Eclipse IDE:

right click on Eclipse project and select "Pull".

If you made some changes into your Eclipse workspace on files that were changed into the GIT remote reference, your GIT client will make a merge automatically.

*If there is conflicts, the merge will mark all conflict files as "conflict" (See later to solve this state).
*If not, you will get all new version files including all your changes.

If you already have commited some files into your local repository, your workspace will be marked as "Merged".
All you have to do is make a commit to validate your local repository as including your changes and changes made by others.

*With the GIT Command Line Client Interface:

<source lang="bash">
git pull
</source>

=Commit and publish your changes=
To see all changes you made into your working directory and waiting to be added into Git:

*With GIT Command Line Interface:

<source lang="bash">
git status
git diff subdir/filename
</source>

To add changes made into your local repository into the GIT index, then commit this index :

*With Eclipse: Right click on file or directory to commit. Select file to add/remove/update into commit.
*With GIT Command Line Interface:

<source lang="bash">
git commit -a -m "Commit text"
</source>
This will save add and changes into your local branch.

To push them on the GIT repository server,

*With Eclipse: right click on project and choose "'''Team - Push to Upstream'''".
*With GIT Command Line Interface:

<source lang="bash">
git push
</source>

To cancel a commit:

*With GIT Command Line Interface, if commit was not already pushed:

<source lang="bash">
git reset --soft HEAD~1
</source>

*With GIT Command Line Interface, if commit was already pushed:

<source lang="bash">
git revert IdCommit or git revert HEAD (for last commit)
</source>

To merge changes done into your forked GIT instance into official Dolibarr instance:

*Go into GitHub web interface of your forked Git instance.
*Click on small button "Create a Pull request".
*Choose commit you request inclusion and validate.

=Ask official project to include your changes=
Once you pushed one or several commit toward your distant fork area on github, you can ask the Dolibarr core team to include it into official project.
For this, follow this tutorial: https://help.github.com/articles/creating-a-pull-request/

=Add an external commit into current repository=
Some developers may work and do commit into their own Git repository after forking the project. If you are interesting into getting this changes, you can import them with the following steps.

You need both Eclipse and GIT Command Line interface to achieve this:

*First, go into GIT setup view and right click on "'''Remotes'''" of your Eclipse Git working space and choose "'''Create a remote...'''"
*Type name or remote fork the developer has create (in most cases, it's developer Git login). For example: "'''thedevlogin'''". Choose also "'''Configure Fetch'''".
*Type URI of Git repository of developer. For example: '''git://github.com/thedevlogin/dolibarr.git'''. Also add a refspec value to declare the branch you want to get. For example: '''refs/heads/master:refs/remotes/thedevlogin/master'''. Click "'''Save and Fetch'''". A new entry will be added into "Remote Tracking" making possible to read/get commits done into this branch.

Now, go on command line of your git repository (in most cases on Linux, it's '''/home/yourlogin/git/yourdolibarr''') and type the git cherry-pick command:
<source lang="bash">
git cherry-pick -x commitid
</source>
where commitid is value of commit id you want to get.

Once this is done, go back to Eclipse and make a refresh on project. You will see modified files appears with decorators (with conflicts if there is).

It the cherry-pick fails because of conflicts, you can cancel the cherry-pick try with
<source lang="bash">
git cherry-pick --abort
</source>

=Solving a conflict=
If a file has been marked as "conflict" after a Pull, open the file to edit it.
Find string "<<<<<<<<<<", you will see part of code that is conflict between "<<<<<<<<<" and ">>>>>>>>". Edit manually code lines and remove "<<<<<<<<" and ">>>>>>>".

Then, right click on file and select "Add".

If you prefer to forget completely all changes you made into all files (so to restore you workspace with content of remote repository), you can make a hard reset:

*With Eclipse: Right click on project top line and select "'''Reset'''" then "'''Hard'''" then "'''Reference - HEAD'''".
*With GIT Command Line Interface: You can achieve this with command

<source lang="bash">
git reset --hard HEAD
</source>
To reset changes you commited but not pushed to origin
<source lang="bash">
git reset --hard origin/develop
</source>

=Tagging sources=
With GIT Command Line Interface:

To add a tag to a current version:
<source lang="bash">
git tag -a -m "Release|Maintenance release x.y.z" "x.y.z"
or
git tag -a -f -m "Beta x.y.betai" "x.y.betai_YYYYMMDD" idcommit # -f force if an existing tag already exists, idcommit allows to choose commit to tag

git push --tags # To push tags to remote origin
</source>

To remove a tag:
<source lang="bash">
git tag -d "x.y.z_YYYYMMDD"
git push remoteentryname :x.y.z_YYYYMMDD # To validate delete on remote origin
</source>

=Creating a new branch=
With GIT Command Line Interface:

Create a clone (see previously) of the branch from where you want to create another branch, then go into directory and launch command:
<source lang="bash">
git branch x.y
git push origin x.y
</source>

With Eclipse:

Create a clone (see previously) of the branch from where you want to create another branch, with a checkout done. The go into view git. Choose branches, remote tracking and select start branch.
Right click and choose "Create branch".
Then make a push to create branch remotely.
Then go into "Remotes - origins" and edit the entries to pull and push onto new branch.
It may also be required to edit the .git/config file to have project linked by default onto new branch.

=Deleting a branch=
With GIT Command Line Interface:

Do a push on branch but add : before name of branch:
<source lang="bash">
git push remoteentryname :branchnametodelete
</source>

=Merging a maintenance branch x.x into dev branch=
With Eclipse:

*Go onto the root directory of project with a checkout of the dev branch.
*Check fetch setup to be sure, this repository contains both information of dev branch and version x.x you want to merge.
*Right click onto root directory and choose "Team - Merge". Select "x.x". Click onto "Merge options - Commit", because we want to commit merged branch if there is no conflicts.
*Once merge is done, check everything is ok.
*Commit and push.

=Pushing a branch onto another Git server=
You may want to synchronize another GIT server.
To synchronize push to another server, this is how to proceed.
With Eclipse:

*Go onto Git clone view and add a remote with a name, choose "Configure push" and enter URL. For example, for name "sourceforge" and URL "ssh://yoursourceforgelogin@git.code.sf.net/p/dolibarr/code"
*Just validate, a first push will be done automatically.
*To force sync, run

<source lang="bash">
git push sourceforge develop
git push --tags sourceforge develop
</source>

=Statistics=
With GIT Command Line interface:

To count number of changes developers have made between a version x and y:

*First, search commit id of tags you want to compare

To find id_start (common commit id between 2 versions/tags)
<source lang="bash">
git merge-base refs/tags/3.3.0 origin/3.4
or
git merge-base 3.7 origin/develop
</source>
To find id_end, choose among
<source lang="bash">
git show-ref
</source>
Choose a value for id_start and id_end
Note: id_end can be HEAD.

*Then run git log to have list of all changes from last common commit to last commit

<source lang="bash">
git log id_start..id_end
</source>

*To get total number of added/deleted lines:

<source lang="bash">
git log --ancestry-path --numstat --pretty="%H" id_start..id_end | awk 'NF==3 {plus+=$1; minus+=$2} END {printf("+%d, -%d\n", plus, minus)}'
</source>

To count number of changes finally between a version x and y (it differs from previous count because in previous count, a change can be done 2 times at two different moment to change differently. With second method, you count changes finally found if changes were ok at first try).

*Use same method than previously but instead of running git log, run git diff.

<source lang="bash">
git diff -b -M --numstat --pretty="%H" id_start..id_end | awk 'NF==3 {plus+=$1; minus+=$2} END {printf("+%d, -%d\n", plus, minus)}'
</source>

More information in GIT usage is available [http://wiki.eclipse.org/EGit/User_Guide here].
[[Category:Development]]

FAQ Get,update GIT project sources

2022-09-23T15:01:48Z

Speaking services:

[[fr:FAQ_Récupérer,_mettre_à_jour_les_sources_GIT_du_projet]]
[[es:FAQ_Recuperar,_actualizar_GIT_fuentes_del_proyecto]]
[[de:FAQ_Get,_update_GIT_Projekt_Quellen]]


[[Category:FAQ EN]]
{{TemplateDocDevEn}}
This is information on how you can get sources of Dolibarr project.
Several methods are described, but we recommand using the one based on GitHub.

 

=Get last version of sources by tgz download=
This method can be used by non technical users.
It allows you to get sources of main development branch (called HEAD) by just downloading a file: This operation consist to get last version of Dolibarr files that are packaged each night into a tgz file. File is available with link:

{{LinkLastSnapshot}}

New files overwrite old ones.
The inconvenient of this method is that you must download and uncompress package each time you want to get updates.

Developers should not use this method to get sources but the next one.

=Get last version of sources using a GIT anonymous access=
You can use this method if you don't have any GIT access. With this method, you won't be able to submit any changes, so, if you are a developer, it is recommended to create a GitHub account and use the next method instead of this one.

==Prerequisite==

*With Eclipse IDE

First you must have a working install of Eclipse. '''EGit''' plugin must also have been installed.
For this, use the '''Find And Install process''' into Eclipse menu, add the GIT update URL:
https://download.eclipse.org/egit/updates
Then choose to install '''EGit''' (No need to choose JGit)

*With the GIT Command Line Client Interface

You need to install GIT client (GIT command line tool with Linux installed with "sudo apt-get install git", or the GIT client for Windows found at https://git-scm.com/download/win).

==Clone process==
First, enter value of the repository with reference sources into your GIT client tool.

*With Eclipse, go into perspective GIT, click onto button "Clone GIT repository". Enter GIT URL of project to get.

GIT Url for Dolibarr official source is:
<source lang="ini">
git://github.com/Dolibarr/dolibarr.git (read only)
or if you created a fork of dolibarr github from github web interface
git@github.com:yourgitaccount/dolibarr.git (read and write access)
</source>
Your Eclipse GIT client will ask you to choose the branches you are interested in. Branches not selected now could be selected later by doing a "Fetch" from the "Remotes" view, but try to choose only the branch you need. This will save you time and problems later.

Note: if you are behind a firewall, you must set Eclipse proxy credentials into Eclipse menu Windows - Preferences - General - Network connection and use the alternative URL:
<source lang="ini">
https://gitlogin:gitpassword@github.com/yourgitaccount/dolibarr.git
</source>

*With GIT on Command Line Interface:

First setup your git client:
<source lang="bash">
git config --global user.name "Your Name"
git config --global user.email "user@domain.com"
git config --list
</source>
Then clone repository locally:
<source lang="bash">
git://github.com/Dolibarr/dolibarr.git (read only)
or if you created a fork of dolibarr github from github web interface
git@github.com:yourgitaccount/dolibarr.git (read and write access)
</source>

Note: if you are behind a firewall, you must set your porxy information and use the alternative https URL:
<source lang="bash">
git config --global http.proxy http://proxyuser:proxypass@proxyserver:proxyport
git clone https://gitlogin:gitpassword@github.com/yourgitaccount/dolibarr.git dolibarr
</source>

Once this step is validated, your GIT client will download all files from remote GIT server. This may last several seconds or minutes.

Once download is finished, you must choose which branch to us to work on.

*With GIT on Command Line Interface;

<source lang="bash">
git checkout develop
git checkout x.y
</source>
This will create local branch and make checkout automatically.

*With Eclipse, right click on "Branches - Remotes - The branch you want to duplicate locally".

Choose "Create Branch" (and check the box "Checkout"). This will duplicate content of branch to work on it locally and will refresh your "Working Directory" to work on this branch.

Create Eclipse project:

If using Eclipse, once your branch is created locally, create a PHP project from assistant by choosing "'''Create from existing project'''" and select directory that is your GIT local repository (Do not choose to create a PHP project from scratch).
Then right click on project from your Eclipse workspace and Choose "'''Team - Share'''". Select GIT and click on option "'''Use or create repository in parent folder of project'''".
An alternate method is File->Import, Git->Project from Git, Select the Git repository and Next, Use New project Wizard -> Php project, enter the folder of you GIT local repository.

Then, you can setup Eclipse to avoid it to scan all project files for its build tools (Outline scanner, TODO scanner, syntax scanner...). This will avoid Eclipse to be too slow. For this, right click on project, choose Build Path and setup it like into following screenshot.

[[File:Eclipse php build path.png|240px]]

=Get last version of sources using a GitHub user access=
==Prerequisite==

*With Eclipse IDE

You must before create an account on GitHub (https://github.com/) and upload a public RSA or DSA certificate into your account profile.

Then, you must have a working install of Eclipse. '''EGit''' plugin must also have been installed.
For this, use the '''Find And Install process''' into Eclipse menu, add the GIT update URL:
https://download.eclipse.org/egit/updates
Then choose to install '''EGit'''.

*With the GIT Command Line Client Interface:

You must before create an account on GitHub (https://github.com/) and upload a public RSA or DSA certificate into your account profile.

Then, you need to install GIT client (GIT command line tool with Linux installed with "sudo apt-get install git", or the GIT client for Windows found at https://git-scm.com/download/win).

==Fork process==
Login to Github, with login you created in previous step. Then go onto page

https://github.com/Dolibarr/dolibarr

And click on button "Fork".

This will create a copy (a fork) of project into your own github area. Because you will be the owner of this fork, you will have all permissions on it to be used in next steps.

==Clone process==
Then process is same as getting sources with anonymous access.

URL to use for GIT clone is same:
<source lang="ini">
git@github.com:YourGitHubLogin/dolibarr.git
</source>

Note that a HTTPS URL is also available but it's sometimes offline (so prefer using first one, link with HTTPS is required only if you are behind a firewall):

<source lang="ini">
https://yourgithublogin@github.com/Dolibarr/dolibarr.git
</source>

=Update your repository=
To update your local workspace:

*With Eclipse IDE:

right click on Eclipse project and select "Pull".

If you made some changes into your Eclipse workspace on files that were changed into the GIT remote reference, your GIT client will make a merge automatically.

*If there is conflicts, the merge will mark all conflict files as "conflict" (See later to solve this state).
*If not, you will get all new version files including all your changes.

If you already have commited some files into your local repository, your workspace will be marked as "Merged".
All you have to do is make a commit to validate your local repository as including your changes and changes made by others.

*With the GIT Command Line Client Interface:

<source lang="bash">
git pull
</source>

=Commit and publish your changes=
To see all changes you made into your working directory and waiting to be added into Git:

*With GIT Command Line Interface:

<source lang="bash">
git status
git diff subdir/filename
</source>

To add changes made into your local repository into the GIT index, then commit this index :

*With Eclipse: Right click on file or directory to commit. Select file to add/remove/update into commit.
*With GIT Command Line Interface:

<source lang="bash">
git commit -a -m "Commit text"
</source>
This will save add and changes into your local branch.

To push them on the GIT repository server,

*With Eclipse: right click on project and choose "'''Team - Push to Upstream'''".
*With GIT Command Line Interface:

<source lang="bash">
git push
</source>

To cancel a commit:

*With GIT Command Line Interface, if commit was not already pushed:

<source lang="bash">
git reset --soft HEAD~1
</source>

*With GIT Command Line Interface, if commit was already pushed:

<source lang="bash">
git revert IdCommit or git revert HEAD (for last commit)
</source>

To merge changes done into your forked GIT instance into official Dolibarr instance:

*Go into GitHub web interface of your forked Git instance.
*Click on small button "Create a Pull request".
*Choose commit you request inclusion and validate.

=Ask official project to include your changes=
Once you pushed one or several commit toward your distant fork area on github, you can ask the Dolibarr core team to include it into official project.
For this, follow this tutorial: https://help.github.com/articles/creating-a-pull-request/

=Add an external commit into current repository=
Some developers may work and do commit into their own Git repository after forking the project. If you are interesting into getting this changes, you can import them with the following steps.

You need both Eclipse and GIT Command Line interface to achieve this:

*First, go into GIT setup view and right click on "'''Remotes'''" of your Eclipse Git working space and choose "'''Create a remote...'''"
*Type name or remote fork the developer has create (in most cases, it's developer Git login). For example: "'''thedevlogin'''". Choose also "'''Configure Fetch'''".
*Type URI of Git repository of developer. For example: '''git://github.com/thedevlogin/dolibarr.git'''. Also add a refspec value to declare the branch you want to get. For example: '''refs/heads/master:refs/remotes/thedevlogin/master'''. Click "'''Save and Fetch'''". A new entry will be added into "Remote Tracking" making possible to read/get commits done into this branch.

Now, go on command line of your git repository (in most cases on Linux, it's '''/home/yourlogin/git/yourdolibarr''') and type the git cherry-pick command:
<source lang="bash">
git cherry-pick -x commitid
</source>
where commitid is value of commit id you want to get.

Once this is done, go back to Eclipse and make a refresh on project. You will see modified files appears with decorators (with conflicts if there is).

It the cherry-pick fails because of conflicts, you can cancel the cherry-pick try with
<source lang="bash">
git cherry-pick --abort
</source>

=Solving a conflict=
If a file has been marked as "conflict" after a Pull, open the file to edit it.
Find string "<<<<<<<<<<", you will see part of code that is conflict between "<<<<<<<<<" and ">>>>>>>>". Edit manually code lines and remove "<<<<<<<<" and ">>>>>>>".

Then, right click on file and select "Add".

If you prefer to forget completely all changes you made into all files (so to restore you workspace with content of remote repository), you can make a hard reset:

*With Eclipse: Right click on project top line and select "'''Reset'''" then "'''Hard'''" then "'''Reference - HEAD'''".
*With GIT Command Line Interface: You can achieve this with command

<source lang="bash">
git reset --hard HEAD
</source>
To reset changes you commited but not pushed to origin
<source lang="bash">
git reset --hard origin/develop
</source>

=Tagging sources=
With GIT Command Line Interface:

To add a tag to a current version:
<source lang="bash">
git tag -a -m "Release|Maintenance release x.y.z" "x.y.z"
or
git tag -a -f -m "Beta x.y.betai" "x.y.betai_YYYYMMDD" idcommit # -f force if an existing tag already exists, idcommit allows to choose commit to tag

git push --tags # To push tags to remote origin
</source>

To remove a tag:
<source lang="bash">
git tag -d "x.y.z_YYYYMMDD"
git push remoteentryname :x.y.z_YYYYMMDD # To validate delete on remote origin
</source>

=Creating a new branch=
With GIT Command Line Interface:

Create a clone (see previously) of the branch from where you want to create another branch, then go into directory and launch command:
<source lang="bash">
git branch x.y
git push origin x.y
</source>

With Eclipse:

Create a clone (see previously) of the branch from where you want to create another branch, with a checkout done. The go into view git. Choose branches, remote tracking and select start branch.
Right click and choose "Create branch".
Then make a push to create branch remotely.
Then go into "Remotes - origins" and edit the entries to pull and push onto new branch.
It may also be required to edit the .git/config file to have project linked by default onto new branch.

=Deleting a branch=
With GIT Command Line Interface:

Do a push on branch but add : before name of branch:
<source lang="bash">
git push remoteentryname :branchnametodelete
</source>

=Merging a maintenance branch x.x into dev branch=
With Eclipse:

*Go onto the root directory of project with a checkout of the dev branch.
*Check fetch setup to be sure, this repository contains both information of dev branch and version x.x you want to merge.
*Right click onto root directory and choose "Team - Merge". Select "x.x". Click onto "Merge options - Commit", because we want to commit merged branch if there is no conflicts.
*Once merge is done, check everything is ok.
*Commit and push.

=Pushing a branch onto another Git server=
You may want to synchronize another GIT server.
To synchronize push to another server, this is how to proceed.
With Eclipse:

*Go onto Git clone view and add a remote with a name, choose "Configure push" and enter URL. For example, for name "sourceforge" and URL "ssh://yoursourceforgelogin@git.code.sf.net/p/dolibarr/code"
*Just validate, a first push will be done automatically.
*To force sync, run

<source lang="bash">
git push sourceforge develop
git push --tags sourceforge develop
</source>

=Statistics=
With GIT Command Line interface:

To count number of changes developers have made between a version x and y:

*First, search commit id of tags you want to compare

To find id_start (common commit id between 2 versions/tags)
<source lang="bash">
git merge-base refs/tags/3.3.0 origin/3.4
or
git merge-base 3.7 origin/develop
</source>
To find id_end, choose among
<source lang="bash">
git show-ref
</source>
Choose a value for id_start and id_end
Note: id_end can be HEAD.

*Then run git log to have list of all changes from last common commit to last commit

<source lang="bash">
git log id_start..id_end
</source>

*To get total number of added/deleted lines:

<source lang="bash">
git log --ancestry-path --numstat --pretty="%H" id_start..id_end | awk 'NF==3 {plus+=$1; minus+=$2} END {printf("+%d, -%d\n", plus, minus)}'
</source>

To count number of changes finally between a version x and y (it differs from previous count because in previous count, a change can be done 2 times at two different moment to change differently. With second method, you count changes finally found if changes were ok at first try).

*Use same method than previously but instead of running git log, run git diff.

<source lang="bash">
git diff -b -M --numstat --pretty="%H" id_start..id_end | awk 'NF==3 {plus+=$1; minus+=$2} END {printf("+%d, -%d\n", plus, minus)}'
</source>

More information in GIT usage is available [http://wiki.eclipse.org/EGit/User_Guide here].
[[Category:Development]]