BiDiB Wiki

Diese Seite ist nicht editierbar. Sie können den Quelltext sehen, jedoch nicht verändern. Kontaktieren Sie den Administrator, wenn Sie glauben, dass hier ein Fehler vorliegt.
====== BiDiBOne aus dem Repository laden ======
<WRAP center round important 80%>
Unser BiDiBOne-Repository - also die Sammlung der Quellen, die für den Bau einer BIDiBOne-AddOn-Anwendung notwendig ist - haben wir derzeit auf [[https://github.com/orgs/BiDiBorg/repositories|Github]] hinterlegt. Dort muss man einen entsprechenden Zugang (Account) eingerichtet haben.

Weiterhin ist zur Verwendung dieser Quellen eine Zugangsberechtigung notwendig, die von [[info@bidib.org]] zur Verfügung gestellt wird.
</WRAP>
Das Dokument {{:pdf_dokumente:anleitung_zu_git.pdf|Anleitung Git}} enthält wichtige Hinweise zur Einrichtung der __dezentralen Versionsverwaltung Git__ und den notwendigen Werkzeugen.

**Beachte**: Bei Nutzung von Eclipse C/C++ als Entwicklungsumgebung ist das im Folgenden beschriebene Vorgehen nicht unbedingt notwendig, da Eclipse seine eigenen Werkzeuge mitbringt! Die Hintergrundinformationen sind allerdings die gleichen.
==== BiDiBOne Basis ====
Die BiDIBOne Basis ist (Stand Sep. 2023) aufgeteilt in die Projekte: **core** (https://github.com/BiDiBorg/bidibone-core) und **support** (https://github.com/BiDiBorg/bidibone-support). Es werden keine Submodule (mehr) verwendet, d.h. alle benötigten Projekte werden separat geladen.

Die aktuelle lauffähige Firmware für die BiDiBOne-Projekte steht auf dem Branch **master** zur Verfügung!

==== BiDiBOne AddOn laden ====
Zum Bau eines neuen AddOns empfiehlt es sich, neben den Basis-Repositorys das Modul AddOnStub (https://github.com/BiDiBorg/bidibone-addonstub) zu laden. Wie das funktionieren könnte, sei am Beispiel von SourceTree und dem Basis-Projekt erklärt. 

(Server/Repository-Adressen: Stand Sep. 2023. Das HTTPS-Protokoll muss u.U. bei bestimmten Einstellungen einer vorgeschalteten Firewall verwendet werden.)

**Hauptmenü => Clone/New**
{{:codehilfe:sourcetree1.jpg|}}
  * **SourcePath/URL**: git@github.com:BiDiBorg/bidibone-addonstub.git **ODER** https://github.com/BiDiBorg/bidibone-addonstub.git
  * **Destination Path und Name**: <parallel zu den Projekten //core// und //support//>
  * (**Checkout branch**: Nötig, wenn man nur auf dem angegebenen Branch arbeiten möchte.)
{{:codehilfe:sourcetree2.jpg|}}
Laden der Quellen ...
{{:codehilfe:sourcetree3.jpg|}}
=> **Close**
{{:codehilfe:sourcetree4.jpg|}}
... das Ergebnis.

**Achtung**, hier wurde der master Branch geladen!

==== Aktuellen Branch einstellen ====
Jetzt muss das Projekt auf einen aktuellen Arbeitsbranch, z.B. OneControl_Anpassung eingestellt werden:
{{:codehilfe:sourcetree5.jpg|}}

Branch anwählen, Kontextmenü (z.B. Rechtsklick), New Branch... auswählen:
{{:codehilfe:sourcetree6.jpg|}}

New Branch, z.B.: OneControl_Anpassung (Stand: Sep. 2023)

=> Create Branch (Jetzt werden die Quellen aus dem Repository bereitgestellt.)
{{:codehilfe:sourcetree7.jpg|}}

Jetzt stehen die benötigten Quellen auf dem angebenen Pfad zur Verfügung. Die Verzeichnisstruktur müsste etwa wie folgt aussehen:
{{:codehilfe:bidibonestruktur.jpg|}}

Jetzt ist der neueste Stand vom Haupt-Repository geladen.

==== Arbeiten mit AtmelStudio6 ====
Zum Arbeiten mit dem AtmelStudio6 steht im Verzeichnis: **AddOnStub/env/AtmelStudio6** die Projektdatei AddOn.cproj zur Verfügung. Die muss ins AddOn-Grundverzeichnis kopiert werden, um die eingestellten Pfade nutzen zu können. Diese Trennung ist notwendig, da nicht jeder Entwickler mit dem AtmelStudio6 arbeitet. Somit verbleiben die "persönlichen" Einstellung auf dem heimischen Rechner.

Mit z.B. einem Doppelklick auf die cproj-Datei startet man bestenfalls jetzt das AtmelStudio6. Das Studio legt (z.B. nach einem Speichervorgang) seine benötigten Dateien an.

<WRAP center round important 85%>
Sollen Änderungen in der Projektdatei im Repository gespeichert werden, müssen sie zuvor von hier ins Ursprungsverzeichnis zurück kopiert werden!
</WRAP>