Testverfahren
Dieses Dokument beschreibt, wie EdeltesterInnen neue Features und Release-Candidates einfach und verlässlich testen können. Der Aufwand zur einmaligen Einrichtung ist etwas höher, damit erhält man aber eine Infrastruktur, die es mit 1Klick(tm) ermöglicht die neuesten Versionen zu testen oder auch zwischen verschiedenen Features zu wechseln.
Um als EdeltesterIn teilnehmen zu können, benötigt man einen GitHub-Account mit aktivierter 2-Faktor-Authentifizierung. Ist ein solcher Account schon vorhanden: prima. Ist er nicht vorhanden, noch nicht dem Projekt Ultraschall zugeordnet oder nicht mit 2-Faktor-Auth versehen: fragt im RocketChat nach.
Man lädt diese schlanke Software herunter: https://desktop.github.com Im Prinzip geht es auch mit jeder anderen Git-Software (inklusive CLI), aber beschrieben wird hier das Vorgehen mit dem GitHub Desktop beschrieben.
Folgt einfach dieser bebilderten Anleitung:
Nach Installation der Software geht ihr oben links auf "Current Repository"
Dann auf "Add"
Dann auf "Clone Repository"
Bleibt auf dem Reiter GitHub.com und tragt Euch unter Sign In mit Eurem GitHub Account ein. Ihr bekommt dann für die 2-Faktor-Authentifizierung eine SMS aufs Handy.
Sucht in der Liste nach dem Repository Ultraschall/ultraschall-portable Wichtig: wenn das dort nicht erscheinen sollte ist euer GitHub Account noch nicht unserem Projekt zugeordnet. Dann bitte im Rocket-Chat kanal #edeltesterinnen Bescheid geben. Wenn ihr das Repository ausgewählt habt, müsst ihr unten noch den lokalen Pfad anpassen. Das ist der Ort, in dem hinterher eure Testversion liegt und gestartet werden kann. Dieser Ort muss unbedingt für euch mit uneingeschränkten Schreibrechten versehen sein - also etwa ein Unterordner in Dokumente. Eher nicht geeignet ist der Applications Ordner.
Hat das geklappt, ist oben links nun unter "Current Repository" ultraschall-portable ausgewählt. Jetzt könnt ihr im Reiter in der Mitte "Current Branch" auswählen, welche Version ihr genau testen wollt. Der "Master" ist stabil, getestet und auch für produktive Aufnahmen geeignet. Er ist unter Umständen aber noch nicht gut dokumentiert, manche Dinge funktionieren vielleicht anders als bisher, dann ist das vermutlich Absicht. Darunter sind die eigentlichen Feature-Branches, in denen jeweils ein aktuell in Bearbeitung befindliches Feature getestet werden Kann. Achtung: Mit einiger Sicherheit sind in den Feature-Branches Bugs enthalten. Nutzt sie nicht zur produktiven Arbeit. Und testet nur das, wozu ihr im Rocket.Chat gebeten werdet - alles andere ist im Zweifel noch arg unfertig und im Bau.
Nach Auswahl des zu testenden Branches könnt ihr oben ganz rechts den Reiter "Fetch Origin" auswählen. Nun wird der jeweilige Branch in euren angegebenen Ordner geladen und kann getestet werden.
Es fehlen dazu aber noch zwei Dateien:
- Die Passende REAPER.app oder .exe Datei. Schaut hierzu im #edeltesterinnen Kanal im Rocket.Chat vorbei, dort sind die jeweils benötigten Versionen zu finden - und zwar als pinned Message.
2 (optional) Wenn ihr eine lizensierte Version von REAPER habt, könnt ihr eure Lizenzdatei ebenfalls in den Ordner Ultraschall-Ordner den ihr unter 5. angegeben habt kopieren. Die Datei heißt 'reaper-license.rk' und die findet ihr so: Startet euer normales REAPER und geht oben im Menü auf 'Options' und dann auf 'Show REAPER ressource path...' - dort liegt dann die Lizenzdatei.
*Wichtig: kommt nicht auf die Idee, auch die REAPER.app / .exe aus dem VErzeichnis zu nehmen - unsere Versionen laufen immer schon mit neueren Versionen.
Das Testen läuft immer in diesen Schritten ab:
Irgendwo im Rocket.Chat werdet ihr aufgefordert, eine Version zu testen. Angegeben ist hier immer der konkrete Branch.
Startet GitHub Desktop und wählt den Branch wie oben unter 6 beschrieben aus. Dann auf "Fetch Origin" gehen wie in oben 7 beschrieben.
Eventuelle andere Testversionen anderer Branches werden nun überschrieben. Ihr könnt aber nach demselben Verfahren wieder zurückwechseln.
Startet in Eurem Testordner REAPER und testet.
Gebt die Rückmeldungen - vor allem Lob und Glückwünsche - entweder im Rocket.Chat oder hier auf GitHub ab. Je nachdem, welchen Weg die EntwicklerInnen des jeweiligen Branches bevorzugen.
Fertig.