Beim entwickeln von Boxely Anwendungen, ist ein häufiger Fehler, das inkorrekte Referieren auf eine externe Datei, um sie in die Anwendung einzubinden. Das Boxely UI Toolkit erlaubt relative Pfade, sowie absolute Pfade in den file URL und box URL Formaten. Relative Pfade und die file/box URL Formate sind unten erklärt.

Relative Pfade verwenden:

Ein relativer Pfad ist ein Teil eines Pfades, relativ zum Speicherort der Haupt .box Datei, die die Anwendung ausführt. Drei Beispiele an relativen Pfaden, um auf eine Datei zu verweisen, um diese zu laden sind:

EineDatei.png
EinOrdner/NochEinOrdner/EineDatei.png
../../EinOrdner/EineDatei.png

Das file URL Format verwenden:

Das "file URL Format" ist folgendes Format, um auf Ressourcen zu referieren und die Datei zu laden:

file://C:/EinOrdner/NochEinOrdner/EineDatei.png

Das box URL Format verwenden:

Das "box URL Format", welches für das OCP Toolkit spezifiziert ist, beschreibt folgendes Format, um auf Dateien zu verweisen und diese als Ressource zu laden:

box://ocpToolkit/NochEinOrdner/EineDatei.png

Das obige Format wird verwendet, um Dateien in der Boxely Installation ausfindig zu machen. Wir verwenden die folgende Boxely Dateistruktur:

|---/RuntimeSupport
      |---/ocpToolkit/ver1_1_1_1
             |---/content
                    |---myBoxFile.box
                    |---myFunctions.js
             |---/resources
                    |---myImageFile.png

Um die myImageFile.png Datei zu referieren, verwenden wir folgende URL:

box://ocpToolkit/resources/myImageFile.png

Das würde zu folgendem relativen Pfad konvertiert:

/RuntimeSupport/ocpToolkit/ver_1_1_1_1/resources/myImageFile.png