ruby2d
v0.12.1
Dies ist das Ruby 2D -Edelstein. Schauen Sie sich die Ruby 2D -Website an, um zu erfahren, wie Sie mit dem Erstellen von 2D -Apps in Ruby beginnen.
Um vor Ort am Edelstein zu arbeiten, klonen Sie zuerst dieses Repo mit:
git clone --recursive https://github.com/ruby2d/ruby2d.git Um die Größe dieses Quellcode -Repositorys klein zu halten, werden Git -Submodule verwendet, um Vermögenswerte zu verweisen. Das --recursive Flag sorgt dafür, dass Submodule initialisiert und aktualisiert werden, wenn dieses Repo kloniert wird. Wenn Sie dieses Repo ohne das --recursive Flag klonen, können Sie Submodules immer noch initialisieren und aktualisieren mit:
git submodule init
git submodule update --remote Aktualisieren Sie diese Submodules jederzeit mit git submodule update --remote oder der rake update -Aufgabe.
Installieren Sie als Nächstes Abhängigkeiten mit Bundler, indem Sie bundle install installieren, um die Entwicklungsgesteine zu erhalten.
Führen Sie zum Schluss rake aus, um das Edelstein lokal zu erstellen und zu installieren. Verwenden Sie rake dev , um die Referenzierung von Benutzer-installierten Bibliotheken (z. B. SDL) zu erstellen.
Ruby 2D verwendet eine Kombination automatisierter Tests über RSPEC und manuelle interaktive Tests, um die Richtigkeit von visuellen, audio- und Eingabefunktionen zu überprüfen. Erstellen Sie das Edelstein und führen Sie alle automatisierten Tests mit dem rake -Befehl aus. Erstellen und führen Sie einen interaktiven Test im test/ Verzeichnis mit rake test:<target> <name_of_test> , zum Beispiel:
# Run `test/testcard.rb` using the standard Ruby interpreter, MRI (CRuby)
rake test:cruby testcard # `test:mri` or just `test` work also
# Build `test/audio.rb` using mruby and run
rake test:mruby audio
# Build `test/mouse.rb` for the web using WebAssembly and run in the default browser
rake test:wasm mouseRuby 2D ist ein völlig Open-Source-Projekt (einschließlich seiner Abhängigkeiten), das von engagierten Leuten erstellt wurde, die glauben, dass die Schaffung von 2D-Anwendungen einfach, natürlich und freudig sein sollte, im Geiste der Rubinsprache selbst.
Wenn Sie sich engagieren möchten, gibt es eine Reihe von Möglichkeiten, dies zu tun:
Schlagen Sie neue Funktionen vor und implementieren Sie. ? Ruby 2d macht schon viel, aber es gibt viele neue Dinge, die es tun könnte. Wenn Sie eine Feature-Anfrage oder einen Vorschlag zur Verbesserung der domänenspezifischen Sprache oder etwas anderes zum Hinzufügen, Entfernen oder Ändern eines neuen Problems haben und uns darüber informieren. Wenn Sie nur beiläufig eine Idee durchgehen möchten, ohne den Druck, ein Problem zu öffnen, senden Sie eine Notiz an die Mailingliste oder chatten Sie mit uns auf dem Gitter.
Fügen Sie Unterstützung für weitere Plattformen hinzu. Ruby 2D zielt darauf ab, die Plattform vollständig zu überschreiten. Helfen Sie uns, die Entwicklererfahrung auf bestehenden Plattformen zu testen und zu verbessern und neue hinzuzufügen.
Finden und beheben Probleme. ? Ihre Hilfe bei der Identifizierung und Behebung von Fehler und der Verbesserung der Leistung auf dem Weg ist entscheidend, um sicherzustellen, dass andere eine solide Erfahrung mit der Bibliothek haben. Schauen Sie sich den Ausgabe -Tracker an und haben Sie es dabei!
Dokumentation schreiben und überprüfen. Wichtig für den Erfolg jedes Open-Source-Projekts ist die Dokumentation. Wir haben einen anständigen Start, aber es gibt immer mehr zu schreiben und zu bearbeiten. Durchsuchen Sie die Ruby 2D -Website und helfen Sie uns, Bereiche zu identifizieren, um Klarheit hinzuzufügen oder Lücken zu füllen. Ganz oben auf den meisten Seiten sehen Sie einen Link zu "Vorschlagen eine Bearbeitung", die direkt zur Quelldatei im Website Repo geht.
Beispiele erstellen und verbessern. ? Wir sind derzeit ein wenig Licht für Beispielanwendungen, um den Leuten zu helfen. Wir würden gerne Ihre Ideen für kleine Einzel-Datei-Apps erhalten, um Benutzer durch bestimmte Funktionen oder Techniken zu führen, die wir im Beispiel-Repository sammeln. Schauen Sie sich das Showcase an, um zu sehen, was die Leute bauen, und lassen Sie sich etwas inspirieren.
Um eine solche Einfachheit zu erreichen, muss unter der Motorhaube viel passieren. Unabhängig davon, ob Sie eine Funktion hinzufügen oder einen Fehler beheben, versuchen Sie Folgendes, um sicherzustellen, dass Ihre Pull -Anfrage zusammengeführt wird. Einige davon mögen entmutigend erscheinen, aber wir helfen gerne auf dem Weg!
Überprüfen Sie, ob es vorhanden ist, und öffnen Sie, falls nicht, eine neue, um eine Diskussion zu beginnen. Bevor Sie Zeit und Energie für eine Idee oder ein Problem widmen, stellen wir sicher, dass sie mit den Prinzipien und Zielen des Projekts übereinstimmt und dass wir eine solide Strategie zum Implementieren und Testen haben.
Verwenden Sie eine Teilmenge von Ruby, die überall funktioniert. Ruby 2D -Anwendungen sind natürlich in Ruby geschrieben. Einige Benutzer können sich dafür entscheiden, die volle Kraft der Sprache, der Standardbibliothek und des Ökosystems von GEMs durch das Schreiben interpretierter Apps zu nutzen, die auf die Standardimplementierung MRT abzielen. Andere möchten möglicherweise das Web über WebAssembly, Mobilgeräte oder native Desktop -Anwendungen erstellen, die alle eine andere Ruby -Implementierung namens MRUBY verwenden. Ruby 2D zielt darauf ab, alle diese Anwendungsfälle selbst mit derselben App -Codebasis zu unterstützen. Ihr Beitrag muss eine Teilmenge von Ruby unterstützen, die mit MRT/Kruby und Mruby mit ähnlicher Weise kompatibel ist und sich ähnlich verhält. Abgesehen von dem Lesen der Dokumentation für jede Ruby -Implementierung können Sie auch Code -Snippets in der Befehlszeile mit ihren jeweiligen Wiederholungen ausprobieren: irb für MRT und mirb für MRUBY.
Testen Sie Ihre Änderung umfassend. Im Gegensatz zu anderen Ruby -Bibliotheken kann nicht alles hier einfach mit Einheitstests abgedeckt werden. Wir müssen auch sicherstellen, dass die Dinge richtig aussehen und klingen, die Eingaben wie erwartet funktionieren und das Verhalten auf allen Plattformen Ruby 2D -Unterstützungen konsistent ist.
rake update aus, um die Submodules zu aktualisieren version.rb , bestimmen Sie Änderungenv#.#.# Und schreiben Sie eine kleine Release -Noterake release , um das Edelstein zu bauen, und schieben Sie es dann auf Rubygemems.org mit gem push ruby2d-#.#.#.gem
