Qualitätssicherung Referenzdokument

Die Qualitätssicherung Referenz beschreibt das Verfahren zur Kontrolle der Qualität der OpenCity stabile Versionen. Wir folgen diesem Verfahren, um sicherzustellen, dass die Endnutzer erhalten keine Defekte OpenCity Stadt Simulation.

OpenCity ist für viele GNU/Linux-Distributionen wie: Debian, Mandriva, Slackware, Ubuntu etc. .. Das vorliegende Dokument betrifft nur die wichtigsten Pakete von OpenCity: die Quelle tar.bz2 komprimierte Datei und die InnoSetup Autoinstaller für Windows.

1. Code Qualität

   Die OpenCity Projekt wurde mit dem Begriff "Portabilität" im Auge behalten. Das bedeutet, dass das Projekt des Codes müssen plattformunabhängig und kann auf beliebig vielen Computer-Architekturen wie möglich zu gestalten. Heute, die 64bits Prozessoren sind häufiger, aber nicht alle haben eine 64-Bit-Computer. Das ist der Grund, warum OpenCity müssen in der Lage zu laufen und zu kompilieren auf beiden 32 und 64bits Architektur ohne jegliche Änderung.

   Um zu erreichen, dass hohes Maß an Portabilität, das Projekt ist codiert mit Standard-C. Jeder Compiler-abhängige extra cool stuff ist stark verboten. Darüber hinaus werden die Codes muss auch gut kommentiert. Die unobvious Algorithmen, die eine magische Berechnung muss kommentiert und illustriert mit einer Pseudo-Code Stück voran.

2. Prüfverfahren

   Der Test Zeitraum, der findet vor der offiziellen Freigabe für den Rest der Welt ist 2 Wochen. Jedes Release muss getestet werden durch mindestens 1 Tester pro unterstütztes Betriebssystem. Die Tester werden gebeten zu prüfen, die unten aufgeführten Punkte.

   1. Die Installation
      1. Linux-Plattform

         Die OpenCity binäre ausführbare und Daten installiert werden können leicht mit dem AutoPackage Autoinstaller. Der Installer zu installieren sind ein Symbol in der "Game"-Menü auf dem Desktop. Wenn der Benutzer klickt auf die OpenCity-Symbol, so muss das Spiel starten, ohne dass zusätzliche Schritt.

         OpenCity Software installiert ist aus den Quellen mit der magischen Formel:

         ./configure && make && make install

         Die Installations-Pfad geändert werden kann, mit dem Argument "--prefix" an "./configure". OpenCity muss Installationspfad unabhängig. Das bedeutet, dass OpenCity arbeiten müssen, auch wenn es installiert ist, in einem anderen Pfad als dem Standard-Präfix "/usr/local/".

      2. Win32-Plattform

         Unter Win32-Plattform, OpenCity kommt mit einem Installationsprogramm, die durch InnoSetup. Der Pfad unabhängige Anforderung noch gilt. Die Endverbraucher können die Installations-Pfad, den sie wollen. Wie auch immer, OpenCity arbeiten müssen.

   2. Running Test
      1. Langfristige Test

         OpenCity sollte ohne Probleme während mindestens 6h. Der Speicherverbrauch muss überwacht werden während dieser Zeit. OpenCity ist nicht erlaubt, jede Speicherverlust. Jede SegFault oder Absturz ist als eine Sperrminorität Bug für eine stabile Release während dieser langfristig Test.

      2. Gameplay-Test

         OpenCity sollte problemlos mit der ganzen Stadt den Bereich gefüllt mit Gebäuden. Allerdings, ein wenig verlangsamen dürfte.

         Die aktuelle Spiel kann auf der Festplatte gespeichert, indem Sie die entsprechenden Bedienelemente. Das Datei-Format speichern ist plattformunabhängig. Es bedeutet, dass der Benutzer muss in der Lage sein, um das Spiel unter einer GNU/Linux-System dann laden Sie es auf einem Windows-oder Macintosh-Plattform und umgekehrt.

   3. Deinstallation Verfahren
      1. Linux-Plattform

         Wenn OpenCity installiert wurde, indem Sie die AutoPackage Autoinstaller, die Deinstallation Prozess wird durch die Autoinstaller. Es besteht aus der Eingabe "-Paket entfernen OpenCity" in der Befehlszeile mit den erforderlichen Zugang Ebene. Bitte lesen Sie die AutoPackage Dokumentation für weitere Informationen über die Befehle.

         Die Deinstallation Verfahren verarbeitet wird mit dem "make uninstall"-Befehl. Ein Bash-Skript "Deinstallieren" werden, die nach dem "$PREFIX/opencity/bin"-Pfad. Es kann auch verwendet werden, um das Programm zu deinstallieren OpenCity.

      2. Win32-Plattform

         Sobald die Installation erfolgreich war, ein Deinstallation shorcut ist innerhalb der OpenCity der Gruppe. Wenn der Benutzer klickt auf, dass die Deinstallation shorcut, OpenCity sollte sauber deinstalliert werden, ohne weitere Maßnahmen.

3. Bug Bericht Verfahren

   Jeder Benutzer ist willkommen Fehler berichtet werden, um die wichtigsten Projekt-Entwickler. Allerdings, jeder Bug-Report muss schriftlich in die richtige Form. Und der wichtigste Punkt ist der Weg zum Reproduzieren des Fehlers anders, es gibt eine sehr kleine Chance, dass der Fehler wird behoben werden in den nächsten Releases.

   Die richtige Bug-Bericht sollte die folgenden Punkte:

   • Betriebssystem: Debian, Mandrake, Win98, WinXP ...
   • Betriebssystem-Version: 3.5 ...
   • OpenCity-Version: 0.0.3beta ...
   • Kurze Beschreibung des Fehlers: OpenCity Abstürze unter WinXP
   • Die komplette Weg zum Reproduzieren des Fehlers.
   • Und alle Informationen, die Sie denken, dass es nützlich für die Fehlersuche. Zum Beispiel: die Ausgabe-Dateien wie stdout.txt, stderr.txt ...