User Apps/Tutorial/Erste Schritte: Unterschied zwischen den Versionen

(Die Seite wurde neu angelegt: „==Vorwort== Hallo Neuling! Für den eigenen Channel eine coole App entwickeln, mit der deine Nutzer Spaß und Unterhaltung genießen, auf dass sie dir in Schar…“)
 
Keine Bearbeitungszusammenfassung
 
(5 dazwischenliegende Versionen desselben Benutzers werden nicht angezeigt)
Zeile 74: Zeile 74:
Sobald du dich mit größeren/komplexeren Apps beschäftigen möchtest lohnt sich aber der Umstieg auf eine richtige IDE.
Sobald du dich mit größeren/komplexeren Apps beschäftigen möchtest lohnt sich aber der Umstieg auf eine richtige IDE.


==Die erste App==
== Die erste App ==
Gemeinsam möchten wir mit dir zusammen eine kleine App basteln. Zuerst werden wir User beim Betreten des Channels begrüßen und verabschieden. Anschließend lassen wir unseren Bot uns noch eine Auswahl an Kaltgetränken servieren.
Wenn du es bis hierhin geschafft hast, dann können wir [[User Apps/Tutorial/Hallo Welt|unsere erste App]] entwickeln!


===Config===
Solltest du Schwierigkeiten, Fragen oder Probleme haben, kannst du dich im Chat jederzeit an das [[User Apps-Team]] wenden.
Jede App braucht eine Konfiguration. In ihr werden Informationen festgelegt, wie zum Beispiel:


"wer darf die App installieren?"
[[Kategorie:User App]] [[Kategorie:Tutorial]]
"Wie heiße die App?"
 
Diese legen wir direkt zu Beginn an.
 
<pre>
appName = HalloWelt
appVersion = 1.0
mayBeInstalledBy.1 = USERNAME.knuddelsDE
autoUpdate = knuddelsDEV
</pre>
 
Auch wenn die Namen sehr einleuchtend klingen, so möchten wir doch eine kurze Erklärung dazu mitgeben.
 
'''appName''' damit können wir einen Namen für unsere App festlegen.
 
'''appVersion''' hier legen wir die Version fest.
 
'''mayBeInstalledBy.N''' Wir können entscheiden ''wer'' und ''wo'' unsere App installiert werden darf. N ist hierbei eine fortlaufende Nummer, es ist immer nur ein Eintrag möglich.
Ein paar Beispiele:
 
<pre>
mayBeInstalledBy.1 = SeipLabDE.knuddelsDE
mayBeInstalledBy.2 = *.knuddelsAT
</pre>
 
Somit könnte SeipLabDE die App auf Knuddels.de installieren, wohingegen auf Knuddels.at jeder (*=wildcard) die App intallieren kann.
 
'''autoUpdate''' hiermit können wir festlegen, dass unsere Dateien regelmäßig und automatisch auf dem Entwicklungsserver aktualisiert werden.
 
Diese Datei können wir nun speichern, dazu gehen wir wie folgt vor:
 
Datei > Speichern unter
 
Dateiname: app.config
 
Dateityp: Alle Dateien
 
===Beispiel-App===
Nun kommen wir zum wichtigsten Teil. Die App selbst.
 
Jede App benötigt erst einmal einen App-Container, dieser sieht so aus:
 
<!-- Wäre es möglich, diesen Block als CODE darzustellen? Der <code>-Tag funktionierte leider nicht -->
<pre>
var App = (new function() {
 
// Unsere App
 
}());
</pre>
 
Natürlich passiert hier noch nicht viel, eigentlich sogar nichts. Das wollen wir aber ändern. Unsere App soll jeden User beim Betreten des Channels begrüßen.
Knuddels stellt uns hier verschiedene Methoden zur Verfügung um auf bestimmte Events zu reagieren.
Mehr dazu: developer.knuddels.de/docs/classes/App.html
 
Für unser Vorhaben benötigen wir die Methode onUserJoined().
 
<!-- Wäre es möglich, diesen Block als CODE darzustellen? Der <code>-Tag funktionierte leider nicht -->
<pre>
var App = (new function() {
 
// Unsere App
 
// Hier speichern wir den Zugriff auf unseren App-Bot
var BOTUSER = KnuddelsServer.getDefaultBotUser();
// Dies ist die von Knuddels vorgegebene onUserJoined-Methode. Durch sie können wir auf den Channelbeitritt eine Users reagieren.
this.onUserJoined = function(user) {
  // Oben haben wir den Zugriff auf unseren Bot gespeichert, diesen nutzern wir hier.
  // Mit der Methode sendPublicMessage() können wir den Bot eine Nachricht schreiben lassen.
  BOTUSER.sendPublicMessage('Hallo, ' + user.getNick() + '.');
};
 
}());
</pre>
 
Damit haben wir unser Ziel schon erreicht. Wir können die Datei nun speichern:
 
Datei > speichern unter
 
Dateiname: main.js
 
Dateityp: Alle Dateien
 
Der Dateiname ist wichtig, Knuddels sucht immer nach der main.js, alle anderen Dateien werden nicht berücksichtig (sie können natürlich in die main.js eingebunden werden).
 
===App hochladen und installieren===
[[Datei:UserApp Erste-Schritte FTP-Server Upload.png|mini|rechts]]
Wir erstellen einen Ordner und nennen ihn "HalloWelt", dorthin kopieren wir unsere beiden Dateien.
 
Nun öffnen wir wieder unseren FTP-Client und stellen eine Verbindung zum Knuddels-Dev-Server her. Dort laden wir nun per Drag&Drop unseren App-Ordner hoch.
 
Anschließend begeben wir uns auf den Developer-Chat in unseren Channel und nutzen den Befehl <function>/apps</function> hier können wir nun unsere App installieren.
 
Wenn wir danach gefragt werden ob wir einen Nick anlegen oder verbinden möchten, wählen wir "Nick anlegen" aus und erstellen einen neuen Nick. Dieser wird fortan unser App-Bot. Jede App benötigt einen eigenen Bot.
 
Nachdem deine App erfolreich gestartet wurde kannst du den Channel neu betreten und solltest nun von deinem persönlichen Bot begrüßt werden! :)
 
===Weitere Aufgaben===
 
Du hast eine kleine App entwickelt. Nun geht es darum auf dieser App aufzubauen und sie weiterzuführen. Wie wäre folgendes:
 
* Nutzer verabschieden, sobald sie den Channel verlassen
* Begrüße ChannelModeratoren auf besondere Art
* Lasse deinen Bot auf öffentliche Nachrichten reagieren

Aktuelle Version vom 2. Mai 2019, 19:25 Uhr

Vorwort

Hallo Neuling! Für den eigenen Channel eine coole App entwickeln, mit der deine Nutzer Spaß und Unterhaltung genießen, auf dass sie dir in Scharen den Channel stürmen. Das ist es doch, was jeder will? Überhaupt kein Problem! Wir möchten dir hier die Welt der User Apps näher bringen.


Um eine eigene User App entwickeln zu können solltest du folgendes mitbringen:

  • Javascript-Grundkenntnisse (oder den Willen, dir selbige anzueignen)
  • Chatstatus: Familienmitglied
  • verifizierte E-Mail Adresse
  • verifizierte Handynummer


Den Rest schaffen wir zusammen!


Ein kurzer Überblick, was wir in diesem kleinem Guide gemeinsam machen werden:

  • wir richten uns einen Entwickler-Account mit Zugang zum Dev-Server ein
  • wir installieren notwendige und praktische Zusatzsoftware
  • wir entwickeln unsere erste kleine App, mit der unsere Besucher begrüßt werden
  • wir installieren die App im Live-Chat
  • wir haben viel Spaß, freuen uns und basteln dann unsere App weiter ;)


Hinweis: Es handelt sich hier nicht um Programmier-Tutorial. Wir erläutern euch nur den Einstieg in die User Apps. Sollten die entsprechenden Programmier-Kenntnisse fehlen, so könnt ihr euch diese z.B unter folgender Seite aneignen:

https://wiki.selfhtml.org/wiki/JavaScript/Tutorials

Registration als Entwickler

Begib dich in den Chat Knuddels.de und nutze den Befehl /apps developer

Hier kannst du dich kinderleicht als Entwickler registrieren. Anschließend erhältst du deine Zugangsdaten im Postfach. Diese sind sehr wichtig und sollten gut verwahrt werden.

Den Developer-Chat findest du unter der Adresse: https://devwww.knuddels.de

Dort kannst du dich mit deinem Benutzernamen und dem von James mitgeteiltem Passwort anmelden.

FTP-Client

Was ist ein FTP-Client?

FTP steht für File Transfer Protocol. Hiermit können wir Dateien von unserem lokalen Rechner auf den Knuddels.de-Server hochladen. Dies ist ein wichtiger Bestandteil in der App Entwicklung. Ein FTP-Client ist zwingend notwendig.

Die Installation eines FTP-Clients

Es gibt eine ganze Reihe verschiedener FTP-Clients. Wir beziehen uns hier auf den FileZilla FTP-Client: https://filezilla-project.org Aber es geht auch jeder andere Client. Die Installation/Konfiguration kann aber entsprechend abweichen. Uns genügt hier der einfache Client, die Pro-Version ist nicht nötig. Während der Installation können alle Angebote für zusätzliche Software ignoriert/abgelehnt werden.

Die Einrichtung des FTP-Clients

Nach der Installation schreiten wir auch schon zur Einrichtung.

Klicke auf den Reiter "Datei" und anschließend auf den Menüpunkt "Servermanager".

Wir legen hier gleich zwei neue Server an. Den ersten Server nennen wir "Knuddels-Dev", den zweiten "Knuddels-Live". Der Knuddels-Dev-Server wird die Zugangsdaten zum Entwicklungsserver beinhalten. Nur hier solltest du deine Apps entwickeln und testen. Erst nach erfolgreichem Test solltest du deine App auf den Knuddels-Live-Server übertragen. Sodann kannst du deine App auf Knuddels.de installieren.

Nun trägst du deinen Benutzernamen und dein Passwort (siehe Nachricht von James) in beide Server ein.

Als Server trägst du ein:

Knuddels-Dev: devappupload.knuddels.de

Knuddels-Live: appupload.knuddels.de

Nun kannst du dich zuerst mit dem Knuddels-Dev-Server verbinden.

Editor

Zum programmieren braucht man einen Editor oder eine IDE (Integrated Development Environment). Für den Anfang reicht uns ein simpler aber leistungsstarker Editor namens Notepad++.

Download: https://notepad-plus-plus.org/download

Dieser Editor muss nicht eingerichtet werden und kann nach der Installation direkt verwendet werden.

Sobald du dich mit größeren/komplexeren Apps beschäftigen möchtest lohnt sich aber der Umstieg auf eine richtige IDE.

Die erste App

Wenn du es bis hierhin geschafft hast, dann können wir unsere erste App entwickeln!

Solltest du Schwierigkeiten, Fragen oder Probleme haben, kannst du dich im Chat jederzeit an das User Apps-Team wenden.

Abgerufen von „https://knuddels-wiki.de/index.php?title=User_Apps/Tutorial/Erste_Schritte&oldid=126808“