Als ich vor einigen Tagen las, dass ICQ 6.5 erschienen ist, war ich zuerst nicht sehr beeindruckt ... verschiedene Fehler, Abstürze und die nervigen Kleinigkeiten hatten mir die Vorgängerversion madig gemacht. Eigentlich hatte ich mir nach dem letzten unbegründeten Absturz geschworen nie wieder ICQ zu verwenden, doch da ich diesem Vorsatz schon das eine oder andere Mal eher versehentlich gebrochen hatte, als ich das noch herumliegende Schnellstart-Icon anklickte, dachte ich mir, dass ich mir die neue Version zumindest einmal ansehen sollte... Das einzige besondere hieran schien allerdings die "Open Xtraz"-Kampagne zu sein:

Ich war also quasi schon wieder in Begriff die Seite zu verlassen, doch irgendwie reizte mich mir zumindest einmal anzuschauen, was sich hinter den Open Xtraz verbarg. Also schaute ich in die Developers Zone und wurde bitter enttäuscht... rund 10 Forumseinträge und nur rudimentäre Anleitungen zu den Xtraz waren nicht gerade was ich mir erhofft hatte. Aber wenigstens gab es eine Liste mit Schritten, die zu befolgen waren, wenn man sein eigenes Xtra entwickeln wollte:

1.) Open Xtraz Developer Tool runterladen

2.) Open Xtraz Template runterladen

3.) Entwickeln und testen

4.) Xtra in die Galerie hochladen

Klingt doch recht einfach - also lud ich mir das DevTool herunter und klickte auf den Link, um das Template herunterzuladen. Das wollte aber nicht auf meinen Rechner wandern, so lange ICQ 6.5 nicht installiert war, also erklärte ich mich auch zu diesem Download bereit.

Nachdem alles installiert war, öffnete ich zuerst den Bildschirm "Meine Xtraz". Dieser war zu dem entsprechenden Zeitraum noch leer. Darum klickte ich auf "Eigenes Xtra erstellen" (rechts unten).

Das öffnete mir aber nicht, wie erwartet, das Entwickler-Tool, sondern brachte mich lediglich wieder auf die Seite der "Developer Zone". Hier musste ich dann auf den entsprechenden Link "Template runterladen" klicken, was ICQ dazu veranlasste ein Verzeichnis auf meiner Platte zu erstellen. Darin zu finden waren zwei Ordner namens "content" und "theme" und einige Konfigurationsdateien. Insgesamt erinnerte mich der Aufbau stark an die Packages, die man für Firefox-Erweiterungen erstellen kann. In einem weiteren Unterordner im Themes Ordner befinden sich die Dateien für die Icons (ICQ besteht übrigens darauf die Namen dieser Dateien nicht zu ändern) - und im "content" Ordner befinden sich eine Javascript-, eine HTML- und mehrere Bilddateien.

Alles in Allem sieht der Inhalt beim Aufruf über die "Meine Xtraz"-Seite ungefähr wie folgt aus:

Hier erkennen wir auch den Grund dafür, dass wir jedes Mal ein neues Template herunterladen müssen - ICQ scheint auf diesem Weg die ID des Templates hochzuzählen ... ob man das nicht auch beim Upload des Xtraz in die Galerie hätte machen können?

Naja - auf jeden Fall wissen wir jetzt, dass es sich nur um HTML und Javascript handelt. Also schauen wir doch mal ins "Developer Tool" ... Ihr ahnt es bereits:

Auch hier ist nicht viel zu holen - statt einer Entwicklungsumgebung oder zumindest etwas, was einem dabei Hilfestellung geben könnte, findet man hier nur eine Oberfläche, um die Meta-Daten des Projekts zu editieren. Einstellbar sind hier unter anderem der Name und die Beschreibung des Projekts, sowie die gewünschte Größe des Fensters, in dem das Xtra angezeigt werden soll.

In der Mitte finden sich dann zwei Radio-Buttons, die darüber entscheiden, wo sich das Projekt befindet ... Der obere Radio-Button (Standard) zeigt einfach auf das Verzeichnis, in das euer Xtra-Template geladen wurde - der untere Radio-Button (und das könnte ganz interessant sein) zeigt auf eine Web-Adresse. Das bedeutet, dass man interaktiven Inhalt z.B. auf seinem eigenen Server hosten könnte - z.B.: um ein Spielchen mit dahinterliegender Datenbank zu erstellen.

Die Verzeichnisse darunter sind eher zu eurer Information, als zu sinnvollen Aktionen nötig - und zwar helfen Sie euch im Jungle von ICQ die Template-Verzeichnisse zu finden :-). Ganz unten ist dann noch ein Link, der ein Zip-Archiv aus dem ganzen Ordner erstellt - und das wäre es schon mit dem "Developer Tool".

Also schauen wir uns doch einmal die Dateien im Ordner selbst an.

Die HTML-Datei:

Die HTML-Datei bindet die mitgelieferte func.js und eine auf dem ICQ-Server liegende Javascript-Datei ein, die die API enthält. Der Rest der Datei ist eigentlich nur CSS und HTML, der in dem oben gezeigten Screenshot resultiert.

Die JS-Datei:

In der JS Datei findet sich als erstes folgende Zeile:

var icqConnector = XtrazConnector.getIcqConnector();

Hierbei wird das XtrazConnector-Objekt der API verwendet, um den sog. IcqConnector zu initialisieren. Sollte man einen Debugger wie z.B. das Visual Studio zur Verfügung haben, so reicht das einfache Schlüsselwort "debugger" schon als erste Zeile in die init Methode eingefügt, und schon entblößt sich der sog. Connector vor uns:

Beim ersten Hineinblicken in diese Oberfläche musste ich doch einmal herzhaft lachen - hatte ich nicht eben noch gelesen, dass die JS Datei, die auf dem ICQ-Server liegt "open_xtraz_wrapper_1.js" heißt? Warum sind wir dann hier schon in ApiVersion 2? ;-) ... naja - Kleinigkeiten ;-D.

Auf jeden Fall sehen wir hier eine grobe Übersicht über die Funktionen, die die Xtraz API bietet. Wir können Alerts erstellen (das sind dann diese kleinen Fenster die rechts über der SysTray auftauchen) und eine Nachricht dorthin übergeben... der Versuch damit zu debuggen stellte sich allerdings als ziemlich nervig heraus, da ich mich selber mit Alerts nur so überflutete und jedes einzelne wegklicken musste ;-).

Eine andere Methode ist z.B. GetUserList(). Diese liefert uns folgendes Objekt:

Hierbei war ich zuerst ein wenig überfordert, denn ich dachte ich könnte auf die Properties des Objekts via Index zugreifen - dies wurde mir jedoch verwehrt. Hätte ich ein wenig früher in die Dokumentation geschaut (die übrigens nicht erklärt wie es geht) hätte ich mir vielleicht ein wenig Suche erspart, denn bei der Methode GetGroupList() wird via Group(idx) auf die Items zugegriffen und so funktioniert es auch hier ... wir können also einfach eine Schleife über "Count" machen und jeweils via Item(idx) darauf zugreifen:

var users = icqConnector.getUserList();

for (var i = 0; i < users.Count; i++)
{
    var user = users.Item(i);
}

Die User Objekte bieten dann die Informationen, die eure Kontakte eingegeben haben - das bedeutet ich hatte in allen Fällen zwar den Nickname der Person zur Hand aber nur äußerst selten echte Namen. Doch das Geburtsdatum war sehr oft ausgefüllt und so beschloss ich eine Geburtstagsliste zum Test zu schreiben. Nach einigen Versuchen sah diese wie folgt aus:

Die Scrollbar musste ich dabei selber einfügen, aber das war schnell bewerkstelligt, da ich aus dem "Developer Tool" ja die fixe Höhe des Fensters kannte und nur ein DIV mit overflow:auto darum zu ziehen brauchte. Natürlich habe ich noch eine kleine Überschrift, sowie einen Link zu meiner Seite eingefügt - aber das war es dann auch schon. Interessant fand ich bei den Arbeiten mit dieser Ansicht übrigens, dass mir ICQ einen Javascript-Fehler warf, als ich versuchte mit innerHTML eine Tabelle zu füllen - aus diesem Grund besteht die obige Auflistung ausschließlich aus floating-DIVs.

Einmal kurz getestet, ob alles funktionierte - und schon konnte es ans Uploaden des Xtraz gehen. Dachteste ... :-D ... Als ich das Projekt hochladen wollte, bekam ich die Meldung dass meine Email-Adresse nicht verifiziert sei ... ok - aus sicherheitsgründen sollten die so etwas machen, damit man kein Schindluder damit treiben konnte ... Aber: Auch nach der Bestätigung meiner Email-Adresse (und ICQ selbst hatte den Link "verifizieren" ausgeblendet), erhielt ich immer noch die Fehlermeldung. Also suchte ich via Google nach einer Lösung für das Problem und fand einen anderen Entwickler, der sagte, dass es bei ihm auch nicht geklappt hätte, bis er sich einen neuen ICQ Account angelegt hätte - widerwillig tat ich dies und wurde ... NICHT ... belohnt ... auch mit dem neuen Account klappte es nicht - also versuchte ich ICQ neuzustarten - und siehe da - ich schaffte es eine Version hochzuladen ...

Da ich aber weder in meinem "My Dev" Bereich auf icq.com noch sonst irgendwo einen Hinweis darauf fand, dass es auch wirklich geklappt hatte, postete ich eien Beschwerde an ICQ, dass irgendwas nicht klappte - und seit ich ein weiteres Mal den Zweitaccount versucht hatte, konnte ich mich mit beiden nicht mal mehr auf der Seite einloggen ...

Mittlerweile habe ich eine Mail von ICQ bekommen ... In dieser steht, dass mein Xtra nicht den Vorgaben entspricht ... Grund: Ich habe kein eigenes Icon... verdammt - also - Icon erstellt und versucht erneut hochzuladen ... offensichtlich haben sie sich meine Beschwerde zu herzen genommen, denn nun steht dort nicht mehr "Mail address not verified" sondern schlicht:

"Upload failed" ... Upload fehlgeschlagen - ohne Begründung - ohne Beschreibung - nichts was darauf hindeutet, dass etwas nicht geklappt hat - ich behaupte ja mal, dass sie einfach die Fehlermeldung verdeckt haben, damit die User nicht sehen, dass sie ihr eigenes System nicht im Griff haben - und in Wirklichkeit steht dort bestimmt immer noch "Mail address not verified".

Fazit:

Ich finde die Idee mit den Open Xtraz echt sehr sehr nett ... ich glaube da könnte man bei einer Netzwerkgröße wie ICQ fast schon einen zweiten AppStore wie von Apple draus machen - aber ich finde sie haben unglaublich Mist bei der Umsetzung gebaut - und ich habe schon so oft vor Wut auf meine Tischplatte eingeschlagen, während ich immer wieder rausflog, vergeblich versuchte mich anzumelden oder Fehler beim Upload bekam, dass ich fast schon keine Lust mehr habe mich damit zu beschäftigen ... Aufruf an ICQ: Behebt die verdammten Fehler - Oder seit nicht so kleinkarriert, dass ihr mir den einzigen erfolgreichen Upload in vier Tagen mit den Worten "Du musst ein eigenes Icon erstellen" zurückschickt. DANKE!

Falls jemand angeregt genug ist sich damit zu beschäftigen und sich nicht von meiner Genervtheit hat anstecken lassen, findet Ihr hier die Referenz der API. Ich wünsche euch viel Spaß beim Bau eures Projekts - es macht Spaß - ihr werdet euch nur mit dem Upload schwer tun ;-)

[Update]

Ca. 3-4 Tage nach meiner zweiten Beschwerde teilte mir ICQ mit, dass sie den Fehler erkannt und behoben haben. Mittlerweile wurde die Geburtstagsliste rund 10.000 Mal runtergeladen. Die Seite in der Galerie findet ihr hier. Mittlerweile funktioniert alles bestens und ich bin froh darüber, dass ICQ die Probleme beheben konnte. Eine Warnung möchte ich euch allerdings noch mit auf den Weg geben. Wenn ihr Alternativ-Clients für das ICQ Netzwerk verwendet, werdet ihr bestimmt genau wie ich bald von Bots genervt werden, die versuchen Kontakt mit euch aufzunehmen. Ich hatte täglich 4-5 Kontaktanfragen von irgendwelchen russischen Accounts. (Und ja - ich habe sogar mal versucht zu antworten, um herauszufinden, ob es sich nicht doch um Interessierte handelt ;-D). Wenn ihr ICQ selbst verwendet, könnt ihr einstellen, dass ihr keine Nachrichten von Leuten außerhalb eurer Kontaktliste haben wollt. Bei ICQ funktioniert das. Bei Trillian scheint dem nicht so zu sein (soweit meine Erfahrung).