Macros

FlashDevelop bietet unter anderem die Möglichkeit die IDE mit Makros verschiedener Art anzupassen. Eine Variante ist dabei CS-Script. Mit den Makros möchte ich mir vier Buttons in die IDE aufnehmen: Simulator, Auf Simulator ausführen, Auf Simulator Debuggen(remote) und Signieren.

Hier ist mein Script:

using System;
using System.Drawing;
using System.Windows.Forms;
using FlashDevelop;
using PluginCore;
using System.Diagnostics;

public class FDScript
{
    public const string SETTINGS_PATH = @"C:\Users\Devbar\AppData\Local\FlashDevelop\Scripts";
    public const string VM_PLAYER_PATH = @"C:\Program Files (x86)\VMware\VMware Player\vmplayer.exe";
    public const string VM_PATH = "\"C:\\Users\\Devbar\\Documents\\Virtual Machines\\PB_094\\PB_094.vmx\"";
    public const string VM_IP = "192.568.426.431";
    public const string VM_DEBUG_IP = "192.568.30.423";
    public const string P12_CERT = "D:\\SDK\\RimKeys\\rimkey_tablet.p12";

    /**
    * Entry point of the script.
    */
    public static void Execute()
    {
        // Get icon for menu items
        Image imgVmImage = Image.FromFile(SETTINGS_PATH + "\\vmware.png");
        Image imgTabletRun = Image.FromFile(SETTINGS_PATH + "\\tablet_run.png");
        Image imgTabletDebug = Image.FromFile(SETTINGS_PATH + "\\tablet_debug.png");
        Image imgTabletSign = Image.FromFile(SETTINGS_PATH + "\\tablet_sign.png");

        // Add a custom button to the toolstrip
        ToolStrip toolstrip = Globals.MainForm.ToolStrip;
        toolstrip.Items.Add(new ToolStripButton("", imgVmImage, OnVmWareClick));
        toolstrip.Items.Add(new ToolStripButton("", imgTabletRun, OnTabletRunClick));
        toolstrip.Items.Add(new ToolStripButton("", imgTabletDebug, OnTabletDebugClick));
        toolstrip.Items.Add(new ToolStripButton("", imgTabletSign, OnTabletSignClick));
    }

    /**
    * run vmware with the simulator
    */
    public static void OnVmWareClick(Object sender, EventArgs e)
    {
        Process.Start(VM_PLAYER_PATH, VM_PATH);
    }

    /**
    * run without debugger
    */
    public static void OnTabletRunClick(Object sender, EventArgs e)
    {
        Run(false);
    }

    /**
    * run with debugger
    */
    public static void OnTabletDebugClick(Object sender, EventArgs e)
    {
        Run(true);
    }

    /**
    * Handles the click event for the menu items.
    */
    public static void OnTabletSignClick(Object sender, EventArgs e)
    {
        Sign();
    }

    /**
    * Runs the blackberry-airpackager to run the application in the simulator.
    * Use the debug flag receive a connection to the remote debugger from simulator.
    */
    private static void Run(bool remoteDebug){
        ProcessStartInfo processInfo = new ProcessStartInfo();
        string pathSwf = null;
        string pathBar = null;
        string pathPng = null;
        string pathArgs = null;
        string path = null;

        pathSwf = PluginBase.CurrentProject.OutputPathAbsolute;
        path = pathSwf.Substring(0,pathSwf.LastIndexOf('\\'));
        pathSwf = pathSwf.Substring(pathSwf.LastIndexOf('\\') +1);
        pathBar = pathSwf.Substring(0,pathSwf.LastIndexOf('.')) + ".bar";
        pathPng = "blackberry-tablet-icon.png";

        pathArgs = "-package " +  pathBar + " " +
                   "-installApp -launchApp application.xml " + pathSwf + " blackberry-tablet.xml " + pathPng + " " +
                   "-device " + VM_IP + " " +
                   "-password pwd";

        if(remoteDebug)
            pathArgs += " -connect " + VM_DEBUG_IP;

        processInfo.WorkingDirectory = path;
        processInfo.FileName = "blackberry-airpackager";
        processInfo.Arguments = pathArgs;

        Process.Start(processInfo);
    }

    private static void Sign(){
        ProcessStartInfo processInfo = null;
        Process process = null;
        string cskPass = null;
        string p12Pass = null;
        string pathSwf = null;
        string pathBar = null;
        string path = null;
        string pathArgs = null;

        pathSwf = PluginBase.CurrentProject.OutputPathAbsolute;
        path = pathSwf.Substring(0,pathSwf.LastIndexOf('\\'));
        pathSwf = pathSwf.Substring(pathSwf.LastIndexOf('\\') +1);
        pathBar = pathSwf.Substring(0,pathSwf.LastIndexOf('.')) + ".bar";

        if (InputBox("Password", "Enter CSK password:", ref cskPass) != DialogResult.OK)
            return;

        if (InputBox("Password", "Enter P12 password:", ref p12Pass) != DialogResult.OK)
            return;

        pathArgs =     "-verbose -cskpass " + cskPass + " " +
                    "-keystore " + P12_CERT + " " +
                    "-storepass " + p12Pass + " " + pathBar + " RDK >> signing.txt";

        processInfo = new ProcessStartInfo();
        processInfo.WorkingDirectory = path;
        processInfo.FileName = "blackberry-signer";
        processInfo.Arguments = pathArgs;

        process = Process.Start(processInfo);
        process.WaitForExit();

        pathArgs =     "-keystore " + P12_CERT + " " +
                    "-storepass " + p12Pass + " " + pathBar + " author >> signing.txt";

        processInfo = new ProcessStartInfo();
        processInfo.WorkingDirectory = path;
        processInfo.FileName = "blackberry-signer";
        processInfo.Arguments = pathArgs;

        process = Process.Start(processInfo);
        process.WaitForExit();
    }

    public static DialogResult InputBox(string title, string promptText, ref string value)
    {
          Form form = new Form();
          Label label = new Label();
          TextBox textBox = new TextBox();
          Button buttonOk = new Button();
          Button buttonCancel = new Button();

          form.Text = title;
          label.Text = promptText;
          textBox.Text = value;

          buttonOk.Text = "OK";
          buttonCancel.Text = "Cancel";
          buttonOk.DialogResult = DialogResult.OK;
          buttonCancel.DialogResult = DialogResult.Cancel;

          label.SetBounds(9, 20, 372, 13);
          textBox.SetBounds(12, 36, 372, 20);
          buttonOk.SetBounds(228, 72, 75, 23);
          buttonCancel.SetBounds(309, 72, 75, 23);

          label.AutoSize = true;
          textBox.Anchor = textBox.Anchor | AnchorStyles.Right;
          buttonOk.Anchor = AnchorStyles.Bottom | AnchorStyles.Right;
          buttonCancel.Anchor = AnchorStyles.Bottom | AnchorStyles.Right;

          form.ClientSize = new Size(396, 107);
          form.Controls.AddRange(new Control[] { label, textBox, buttonOk, buttonCancel });
          form.ClientSize = new Size(Math.Max(300, label.Right + 10), form.ClientSize.Height);
          form.FormBorderStyle = FormBorderStyle.FixedDialog;
          form.StartPosition = FormStartPosition.CenterScreen;
          form.MinimizeBox = false;
          form.MaximizeBox = false;
          form.AcceptButton = buttonOk;
          form.CancelButton = buttonCancel;

          DialogResult dialogResult = form.ShowDialog();
          value = textBox.Text;
          return dialogResult;
    }
}

Installation

1. Das komplette Paket (Script und Bilder) kann  hier heruntergeladen werden.
2. Ruft in FlashDevelop Tools->Application Files auf und entpackt dort in einen Unterordner “Scripts” die Dateien aus der Script.zip.
3. Die Einstellungen im oberen Bereich der Playbook.cs müsst ihr auf eure Umgebung anpassen.
4. Legt in FlashDevelop unter Macros->Edit Macros einen neuen Eintrag mit folgenden Einstellungen an:
• AutoRun: True
• Entries [0]: ExecuteScript|Internal;C://Users//Devbar//AppData//Local//FlashDevelop//Scripts//Playbook.cs
• Image: <kann leer bleiben>
• Label: <beliebig>
• ShortCut: None
5. FlashDevelop muss neu gestartet werden, damit die Einträge sichtbar werden.

Simulator

Startet VMWare und lädt die in der Playbook.cs konfigurierte VM.

Ausführen

Packt eure App als Bar-File und startet sie auf dem Simulator.

Debugger

Packt eure App als Bar-File und startet sie auf dem Simulator. Damit das Remote-Debuggen korrekt funktioniert muss vorher per Debug->Start Remote Session FlashDevelop in Wartestellung gebracht werden. Bitte achtet darauf, dass ihr in die Playbook.cs die korrekt IP-Adresse eingerichtet habt.

Signieren

Signiert eine bestehende Bar-File mit dem in der Playbook.cs angegebenen Zertifikat. Passwörter werden vom Script abgefragt.

Links:

• CS-Script
• FlashDevelop: Macros

Los geht’s

Bevor ihr startet, solltet ihr euch das wirklich hervorragende Tutorial von studio|chris anschauen.

Das Script

Hier haben wir das Script für unser Tool. Eigentlich nichts spektakuläres. Aber der Teufel liegt im Detail.

Woher kommt QNXStageWebView?

QNXStageWebView steckt in qnx-air.swc. Die Library ist im SDK-Pfad im Unterorder frameworks\libs\air. Die Datei müsst ihr eurem Projekt hinzufügen, wie ihr das auch schon von der qnx-screen.swc und spark.swc kennt. Auch hier müsst ihr den Menüeintrag “Add to Library” ausführen. Allerdings gibt es hier die Besonderheit, dass ihr über die Optionen der Library festlegen müsst, dass es sich um eine “External library” handelt. Der Grund dafür ist, dass die qnx-air.swc zur Laufzeit angebunden werden muss, da Playbook-spezifische Aufrufe enthalten sind.

Class qnx.media::QNXStageWebView could not be found

Diese Meldung werdet ihr immer bekommen, wenn ihr versucht die Anwendung direkt aus FlashDevelop und nicht über den Simulator zu starten. Der Grund ist, wie gesagt, dass die Libraries erst auf dem Playbook zur Laufzeit dynamisch eingehängt werden. Leider lässt sich daher unsere Anwendung nur im Simulator testen.

Ergebnis

Links:

• FlashDevelop
• studio|chris
• petefreitag

Download

• WebBrowser

Hier vielleicht nochmal ein kleiner Nachtrag für alle, die sich jetzt auch in Adobe-AIR für das Playbook stürzen wollen. Unter diesem Link findet ihr eine sehr nützliche Anleitung zum Einstieg in FlashDevelop + Blackberry Tablet SDK. Englischkenntnisse werden vorausgesetzt

Die letzten Wochen habe ich fleißig an meiner ersten Playbook-App gebastelt. RIM hat nämlich versprochen, dass es für Entwickler die Apps einreichen das Playbook für lau gibt. Hab’ ich ja nicht so recht dran geglaubt. Aber so wie’s aussieht bin ich wohl unter den Glücklichen *freu*.

Mein Beitrag ist übrigens ein kleiner Texteditor mit dem Namen BluePad.

Die Aktion wurde bis zum 15. März verlängert. Das Gerät kommt logischerweise erst, wenn es auch zu kaufen ist.

Links:

• BluePad
• Free Blackberry Playbook offer

Vorbereitung

Wichtig ist, dass ihr bevor ihr das untenstehende Snippet ausprobieren könnt, eurem Widget ein paar API-Referenzen hinzufügen müsst. Dazu öffnet ihr die config.xml in Visual Studio. Im Bereich “Widget Permissions” geht ihr auf “Add Feature” und wählt diese Einträge aus:

• blackberry.message
• blackberry.find
• blackberry.identity

Wenn ihr wissen wollt, wass sich hinter den anderen Einträgen verbirgt und was man sonst so alles mit der API machen kann, empfehle ich euch die Widget-API-Doku.

Aufruf

Danach könnt ihr den Code z.B. in den Clicked-Event eures Buttons einfügen. Viel Spaß beim Ausprobieren.

                // Location neu ermitteln
                blackberry.location.refreshLocation();

                var loc = "Latitude: " + blackberry.location.latitude + "\r\n";
                loc += "Longitude: " + blackberry.location.longitude;

                var message = new blackberry.message.Message();
                message.toRecipients = "my@example.com";
                message.subject = "Hier bin ich";
                message.body = loc;
                message.send();

Um so überraschter war ich, dass es tatsächlich aktuelle Plugins für Visual Studio zum Entwickeln von BB-Widgets und BB-Webanwendungen gibt. .NET-Technologie wird hier zwar bestenfalls im Backend zum Einsatz kommen, aber hey! Visual Studio!

Auf in ein Welt voller Spannung und Abenteuer

Vorbereitung der Entwicklungsumgebung

Ihr braucht:

• Visual Studio 2008 mindestens mit SP1
• Java SDK mindestens in der Version 1.6 [link]
• BlackBerry Plug-in for Microsoft Visual Studio v2.0 [link]

Ich weiß leider nicht ob die Express-Edition von Visual Studio reicht und kann dies hier auch schlecht testen. Wer als erstes in die Comments postet ob’s geht, gewinnt … äh meinen Respekt und meine Anerkennung .

Beim Download der Plugins müsst ihr mal wieder ein bischen was über euch zum Besten geben. Mein Tipp an dieser Stelle: Einfach lügen und Trashmail nutzen . Bei der Installation ist weiter nichts zu beachten (immer schön Next, Next, Finished).

Die Windows 7-Falle

Nachdem ihr alles soweit installiert habt bekommen die Windows 7 Benutzer noch eine Extraaufgabe. Es ist anscheinend so, dass in Windows 7 der Pfad für Java nicht mehr in die Umgebungsvariable PATH geschrieben wird. Mir persönlich ganz Recht, da PATH sowieso irgendwann überläuft und man den Überblick verliert.

D.h. per Notepad die Datei C:\Program Files (x86)\Research In Motion\BlackBerry Widget Packager\bin\bbwp.properties öffnen und im Tag “<java>” den Pfad zum SDK angeben.

<java>C:\Program Files (x86)\Java\jdk1.6.0_20</java>

Die Anwendung erstellen

Ein Video sagt ja mehr als tausend Zeilen. Deswegen hier die Anleitung, wie ihr eure erste “Hallo Welt”-Anwendung in Visual Studio erstellt.

Die Anwendung testen

Wenn das soweit geklappt hat, könnt ihr das Ergebnis testen. Da es während der Entwicklung ziemlich umständlich ist nach jeder Zeile Code die Anwendung erneut auf euren BlackBerry zu kopieren, gibt es zum Testen einen Emulator. In der aktuellen Version kann ein BlackBerry 9550 Storm und ein BlackBerry 9700 Bold emuliert werden.

Die Anwendung verteilen

Um die Anwendung auf euren Blackberry zu installieren könnt ihr natürlich einfach die entsprechenden Datei (BlackBerryHelloDevBar.cod) aus dem Unterverzeichnis StandardInstall auf euren Blackberry übertragen und dort öffnen.

Ein anderer Weg ist das Verteilen per IIS. Wenn ihr bereits einen IIS installiert habt, solltet ihr eine neue Website mit dem Namen blackberry anlegen. In das Verzeichnis legt ihr die Dateien BlackBerryHelloDevBar.cod und BlackBerryHelloDevBar.jad. Die neue Website sollte das Auflisten von Dateien erlauben. So könnt ihr beliebig viele neue Anwendung in das Verziechnis ablegen und anbieten. Damit die Dateien verfügbar und installierbar sind, müssen allerdings noch drei Einträge für die MIME-Typen konfiguriert werden.

• .jad: text/vnd.sun.j2me.app-descriptor
• .jar: application/java-archive
• .cod: application/vnd.rim.cod

MIME-Typen im IIS konfigurieren

Wenn ihr die Site jetzt mit eurem BlackBerry ansurft, solltet ihr die Testanwendung downloaden und installieren können.

Fazit

Ich hoffe ihr habt einen kleinen Einblick bekommen. Das fertige Projekt könnt ihr zum rumprobieren auch hier downloaden.

• BlackBerryHelloDevBar

Demnächst werde ich mal ein paar API-Examples programmieren und hier posten.