{"id":3275,"date":"2023-12-10T17:30:41","date_gmt":"2023-12-10T16:30:41","guid":{"rendered":"https:\/\/ictknow-how.ch\/blog\/?p=3275"},"modified":"2023-12-12T12:15:33","modified_gmt":"2023-12-12T11:15:33","slug":"wie-kann-man-bei-lidarr-beitragenein-ausfuehrlicheres-how-to-contribute","status":"publish","type":"post","link":"https:\/\/ictknow-how.ch\/blog\/2023\/12\/10\/wie-kann-man-bei-lidarr-beitragenein-ausfuehrlicheres-how-to-contribute\/","title":{"rendered":"Wie kann man bei Lidarr beitragen?
Ein ausf\u00fchrlicheres \u00abHow to Contribute\u00bb"},"content":{"rendered":"\n

Wer gerne beim Open-Source-Projekt Lidarr mitmachen m\u00f6chte, der wird sicher schon die offizielle Wiki-Seite und den Abschnitt „Lidarr Contributing<\/a>“ gefunden haben. Leider ist deren Anleitung nur sehr oberfl\u00e4chlich und l\u00e4sst entscheidende Punkt aus.<\/p>\n\n\n\n

Hier folgt eine ausf\u00fchrlichere Variante, in der die wirklich wichtigen Schritte erkl\u00e4rt werden.<\/p>\n\n\n\n

Wichtig ist die grunds\u00e4tzliche Unterscheidung<\/strong> ob man beim sogenannten Backend<\/strong> mit entwickeln will oder beim Frontend<\/strong> (oder bei beiden).
Das Backend ist in C#<\/code> programmiert und enth\u00e4lt die ganze Logik die „hinten rum“ abl\u00e4uft.
Das Frontend ist all das, was man im Browser sieht und bedient, also z.B. die Farben, Formen, Buttons, Eingabefelder. Das Frontend ist in HTML<\/code> und Javascript<\/code> programmiert.<\/p>\n\n\n\n

Fangen wir mit dem einfacheren Teil, der Backend-Entwicklung an.<\/p>\n\n\n\n

Was braucht man um im Lidarr-Backend<\/strong> Ver\u00e4nderungen vorzunehmen?<\/p>\n\n\n\n

Um den C#<\/code>-Code bearbeiten und ausf\u00fchrbar kompilieren zu k\u00f6nnen, braucht man eine Entwicklungsumgebung (eine sogenannte IDE<\/a>). Ein bekanntes Beispiel daf\u00fcr ist das \u00abMicrosoft Visual Studio\u00bb. Das bekommt man in der Community-Edition kostenlos direkt beim Hersteller: https:\/\/visualstudio.microsoft.com\/de\/downloads\/<\/a><\/p>\n\n\n\n

Nach der Grundinstallation w\u00e4hlt man im \u00abVisual Studio Installer\u00bb einen sogenannten „Workload“. Das ist eine vorgew\u00e4hlte Sammlung von Tools, Einstellungen und Abh\u00e4ngigkeiten. F\u00fcr die Entwicklung von Lidarr w\u00e4hlen wir hier „.NET-Desktopentwicklung“:<\/p>\n\n\n\n

\"\"<\/a>
Diese Einstellung kann man im \u00abVisual Studio Installer\u00bb nachtr\u00e4glich jederzeit anpassen.<\/figcaption><\/figure>\n\n\n\n

Ausserhalb des Visual Studios l\u00e4dt man sich von Github im Projekt Lidarr<\/a> den kompletten Source-Code von Lidarr herunter.
(Wer jetzt einwendet, dass man das doch direkt und integriert aus dem Visual Studio heraus machen kann: Mit diesem Wissen wird man kaum diese Anleitung lesen…)<\/em>
Dazu klickt man auf den sogenannten Branch „develop“ (oder \u00e4ndert den Eintrag auf die „Verzweigung“ mit diesem Namen), dann auf den gr\u00fcnen Button „Code“ und daraus zuunterst auf „Download ZIP“:<\/p>\n\n\n\n

\"\"<\/a><\/figure>\n\n\n\n

Dieses heruntergeladene ZIP-File (rund 41 MB) entpackt man, z.B. direkt in das Standard-Code-Verzeichnis f\u00fcr Visual C# unter %USERPROFILE%\\Documents\\Visual Studio 2022\\Code Snippets\\Visual C#<\/code>. Das entpackte ZIP-Archiv sollte ungef\u00e4hr so aussehen:<\/p>\n\n\n\n

\"Dieses<\/a><\/figure>\n\n\n\n

Hinweis zum automatisch erstellten Verzeichnisnamen Visual C# <\/strong>
Das Sonderzeichen #<\/strong> im Verzeichnisnamen „\\Visual C#<\/strong>“ f\u00fchrt bei der sp\u00e4teren Verwendung von Yarn<\/code> zu Fehlermeldungen. Deshalb empfehle ich den Standard-Verzeichnisnamen den Visual Studio anlegt manuell auf z.B. „\\Visual CS<\/code>“ (f\u00fcr C<\/strong>–S<\/strong>harp) abzu\u00e4ndern.<\/em><\/p>\n\n\n\n

Dann klickt man in diesem lokalen Source-Code-Verzeichnis auf das Unterverzeichnis \\src<\/code> und darin auf Lidarr.sln<\/code>. Das l\u00e4dt einem s\u00e4mtliche ben\u00f6tigten Backend-Teile ins Visual Studio. Um nun z.B. die Windows-Variante kompilieren zu k\u00f6nnen – ohne auch nur die geringste \u00c4nderung am Code vorgenommen zu haben – wechselt man im gestarteten „Visual Studio 2022“ die Projektmappen-Plattform von \u00abPosix\u00bb auf \u00abWindows\u00bb und das Startprojekt von \u00abLidarr.API.v1\u00bb auf \u00abLidarr\u00bb. Beim allerersten Laden der 25 Teilprojekte, dauert das vollautomatische nachladen von fehlenden NuGet-Paketen mehrere Minuten. Bitte warten bis unten in der Taskleiste keine solchen Eintr\u00e4ge mehr durchlaufen:<\/p>\n\n\n\n

\"\"<\/a><\/figure>\n\n\n\n

Bei einer komplett neuen Visual Studio–Installation wird das .NET 6.0-Zielframework fehlen:<\/p>\n\n\n\n

\"\"<\/a><\/figure>\n\n\n\n

Deshalb auf das blaue Wort „Installieren“ klicken und den Abschluss der Installation abwarten. Meistens muss man dazu das Visual Studio selber schliessen, damit der separat gestartete \u00abVisual Studio Installer\u00bb das Zielframework herunterladen und konfigurieren kann:<\/p>\n\n\n\n

\"\"<\/a><\/figure>\n\n\n\n

Nach Abschluss der Zielframework-Installation kann man nun das neu ins Visual Studio geladene Projekt Lidarr.sln<\/code> wie gewohnt \u00fcber den grossen gr\u00fcnen Debug-Button (=F5) starten.<\/p>\n\n\n\n

\"\"<\/a><\/figure>\n\n\n\n

Nach etwa einer halben Minuten Kompilierungszeit landet man aber leider frustriert auf dem Boden der Realit\u00e4t: Es geht zwar ein Browser auf, aber darin sieht man nur eine lapidare 404-Fehlermeldung:<\/p>\n\n\n\n

\"\"<\/a>
404 not found Fehlermeldung wegen nicht bereitgestelltem Frontend<\/figcaption><\/figure>\n\n\n\n

Das Backend versucht hier n\u00e4mlich das sichtbare Frontend im lokalen Browser aufzurufen. Dieses Frontend wurde aber noch gar nicht bereitgestellt.<\/p>\n\n\n\n

Das erledigen wir im aufw\u00e4ndigeren zweiten Teil dieser Anleitung<\/a>.<\/p>\n\n\n

\n \n
\n \n
\n
\n \n\n
<\/div>\n <\/div>\n
\n \n\n
<\/div>\n <\/div>\n
\n \n\n
<\/div>\n <\/div>\n
\n \n\n
<\/div>\n <\/div>\n
\n \n\n
<\/div>\n <\/div>\n <\/div>\n \n
\n
\n \n\n
<\/div>\n <\/div>\n
\n \n\n
<\/div>\n <\/div>\n
\n \n\n
<\/div>\n <\/div>\n
\n \n\n
<\/div>\n <\/div>\n
\n \n\n
<\/div>\n <\/div>\n <\/div>\n<\/div>\n \n\n
\n Rate this post<\/span>\n <\/div>\n <\/div>\n","protected":false},"excerpt":{"rendered":"

Wer gerne beim Open-Source-Projekt Lidarr mitmachen m\u00f6chte, der wird sicher schon die offizielle Wiki-Seite und den Abschnitt „Lidarr Contributing“ gefunden haben. Leider ist deren Anleitung nur sehr oberfl\u00e4chlich und l\u00e4sst entscheidende Punkt aus. Hier folgt eine ausf\u00fchrlichere Variante, in der die wirklich wichtigen Schritte erkl\u00e4rt werden. Wichtig ist die grunds\u00e4tzliche Unterscheidung ob man beim sogenannten … Weiterlesen<\/a><\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[28,278],"tags":[283,282,279,284,285,277,280,281],"class_list":["post-3275","post","type-post","status-publish","format-standard","hentry","category-software","category-visual-studio","tag-c","tag-c-sharp","tag-entwicklung","tag-html","tag-javascript","tag-lidarr","tag-node-js","tag-yarn"],"_links":{"self":[{"href":"https:\/\/ictknow-how.ch\/blog\/wp-json\/wp\/v2\/posts\/3275","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/ictknow-how.ch\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/ictknow-how.ch\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/ictknow-how.ch\/blog\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/ictknow-how.ch\/blog\/wp-json\/wp\/v2\/comments?post=3275"}],"version-history":[{"count":0,"href":"https:\/\/ictknow-how.ch\/blog\/wp-json\/wp\/v2\/posts\/3275\/revisions"}],"wp:attachment":[{"href":"https:\/\/ictknow-how.ch\/blog\/wp-json\/wp\/v2\/media?parent=3275"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/ictknow-how.ch\/blog\/wp-json\/wp\/v2\/categories?post=3275"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/ictknow-how.ch\/blog\/wp-json\/wp\/v2\/tags?post=3275"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}