Ontwikkeling van ADOBE AIR 1.5-toepassingen met ADOBE FLASH CS4 PROFESSIONAL

Ontwikkeling van ADOBE AIR 1.5-toepassingen met ADOBE FLASH CS4 PROFESSIONAL ®

®

®

™

© 2008 Adobe Systems Incorporated. Alle rechten voorbehouden. Copyright

Ontwikkeling van Adobe® AIR™ 1.5-toepassingen met Adobe® Flash® CS4 Indien deze handleiding wordt gedistribueerd met software die een gebruiksrechtovereenkomst bevat, valt deze handleiding, samen met de hierin beschreven software, onder een licentie en mag deze alleen worden gebruikt of gekopieerd in overeenstemming met de voorwaarden van een dergelijke licentie. Tenzij dit wordt toegestaan door een dergelijke licentie, mag geen enkel deel van deze handleiding worden gereproduceerd, opgeslagen in een ophaalsysteem of worden verzonden in enige vorm of op enige wijze, elektronisch, mechanisch, opname of anderszins, zonder voorafgaande schriftelijke toestemming van Adobe Systems Incorporated. De inhoud van deze handleiding wordt auteursrechtelijk beschermd, ook als deze niet wordt gedistribueerd met sofware die een gebruiksrechtovereenkomst bevat. De inhoud van deze handleiding dient alleen ter informatie en kan zonder voorafgaande berichtgeving worden gewijzigd en kan niet worden geïnterpreteerd als een verplichting van de zijde van Adobe Systems Incorporated. Adobe Systems Incorporated aanvaardt geen verantwoordelijkheid of aansprakelijkheid voor eventuele fouten in de inhoud van deze handleiding. Bestaande illustraties of afbeeldingen die u in uw project wilt invoegen, kunnen auteursrechtelijk zijn beschermd. Bij het onrechtmatig invoegen van dergelijk materiaal in uw werk wordt het auteursrecht van de copyright-eigenaar geschonden. Zorg dat u toestemming hebt van de copyright-eigenaar als u dit materiaal gebruikt. Eventuele bedrijfsnamen of namen van personen in voorbeeldsjablonen dienen slechts om het gebruik van het product te illustreren en zijn fictief. Adobe, the Adobe logo, Acrobat, ActionScript, Adobe AIR, ColdFusion, Dreamweaver, Flash, Flex, Flex Builder, and Reader are either registered trademarks or trademarks of Adobe Systems Incorporated in the United States and/or other countries. Microsoft and Windows are either registered trademarks or trademarks of Microsoft Corporation in the United States and/or other countries. Apple, Macintosh, and Mac OS are trademarks of Apple Inc., registered in the United States and other countries. Java is a trademarks or registered trademark of Sun Microsystems, Inc. in the United States and other countries. Linux is the registered trademark of Linus Torvalds in the U.S. and other countries. All other trademarks are the property of their respective owners. This work is licensed under the Creative Commons Attribution Non-Commercial 3.0 License. To view a copy of this license, visit http://creativecommons.org/licenses/by-nc/3.0/us/ This product includes software developed by the Apache Software Foundation (http://www.apache.org/) MPEG Layer-3 audio compression technology licensed by Fraunhofer IIS and Thomson Multimedia (http://www.mp3licensing.com). Speech compression and decompression technology licensed from Nellymoser, Inc. (www.nellymoser.com) Video compression and decompression is powered by On2 TrueMotion video technology. © 1992-2005 On2 Technologies, Inc. All Rights Reserved. http://www.on2.com. This product includes software developed by the OpenSymphony Group (http://www.opensymphony.com/) This product contains either BSAFE and/or TIPEM software by RSA Security, Inc. Sorenson Spark™ video compression and decompression technology licensed from Sorenson Media, Inc. This product includes software developed by the IronSmith Project (http://www.ironsmith.org/). Adobe Systems Incorporated, 345 Park Avenue, San Jose, California 95110, USA. Notice to U.S. Government End Users. The Software and Documentation are “Commercial Items,” as that term is defined at 48 C.F.R. §2.101, consisting of “Commercial Computer Software” and “Commercial Computer Software Documentation,” as such terms are used in 48 C.F.R. §12.212 or 48 C.F.R. §227.7202, as applicable. Consistent with 48 C.F.R. §12.212 or 48 C.F.R. §§227.7202-1 through 227.7202-4, as applicable, the Commercial Computer Software and Commercial Computer Software Documentation are being licensed to U.S. Government end users (a) only as Commercial Items and (b) with only those rights as are granted to all other end users pursuant to the terms and conditions herein. Unpublished-rights reserved under the copyright laws of the United States. Adobe Systems Incorporated, 345 Park Avenue, San Jose, CA 95110-2704, USA. For U.S. Government End Users, Adobe agrees to comply with all applicable equal opportunity laws including, if appropriate, the provisions of Executive Order 11246, as amended, Section 402 of the Vietnam Era Veterans Readjustment Assistance Act of 1974 (38 USC 4212), and Section 503 of the Rehabilitation Act of 1973, as amended, and the regulations at 41 CFR Parts 60-1 through 60-60, 60-250, and 60-741. The affirmative action clause and regulations contained in the preceding sentence shall be incorporated by reference.

iii

Inhoud Hoofdstuk 1: Adobe AIR installeren Adobe AIR installeren . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 Adobe AIR verwijderen

................................................................................................ 2

AIR-voorbeeldtoepassingen installeren en uitvoeren

................................................................... 2

Hoofdstuk 2: Installatie van Flash CS3 voor Adobe AIR Systeemvereisten voor de Adobe AIR-update voor Flash CS3 Installatie van de Adobe AIR-update voor Flash CS3

........................................................... 3

.................................................................... 3

Installatie van de Adobe AIR-update voor Flash CS3 verwijderen AIR-uitbreidingen van Flash CS3

........................................................ 4

....................................................................................... 5

Hoofdstuk 3: Inleiding tot Adobe AIR Nieuw in AIR 1.1 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7 Nieuw in AIR 1.5

....................................................................................................... 8

Hoofdstuk 4: AIR-bronnen zoeken Hoofdstuk 5: Uw eerste AIR-applicatie maken met Flash CS3 of CS4 De Hello World-toepassing in Flash maken . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10 De toepassing testen

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10

Een FLA-toepassing converteren naar een Adobe AIR-toepassing

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12

Hoofdstuk 6: Adobe AIR-update voor Flash CS3 Professional Een Adobe AIR-bestand aanmaken . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13 Adobe AIR-publicatie-instellingen installeren Voorbeeld van een Adobe AIR-toepassing

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15

Het debuggen van een Adobe AIR-toepassing

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15

AIR-toepassings- en installerbestanden aanmaken

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16

Een aangepast descriptor-bestand van de toepassing aanmaken Uw toepassing ondertekenen

Hoofdstuk 7: Beveiliging in AIR Basisbeginselen van beveiliging in AIR Installatie en updates Sandboxen

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28

Beveiliging in HTML

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31

Scripting tussen de inhoud van verschillende domeinen Naar schijf schrijven

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40

Veilig werken met niet-vertrouwde inhoud

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41

Aanbevolen beveiligingsprocedures voor ontwikkelaars Codeondertekening

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44

Hoofdstuk 8: Eigenschappen van AIR-toepassingen instellen De structuur van het descriptorbestand van de toepassing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45 Eigenschappen definiëren in het descriptorbestand van de toepassing

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46

ONTWIKKELING VAN ADOBE AIR 1.5-TOEPASSINGEN MET FLASH CS4 PROFESSIONAL iv Inhoud

Hoofdstuk 9: Functionaliteit die specifiek is voor Adobe AIR AIR-specifieke klassen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55 Runtimeklassen met AIR-specifieke functionaliteit

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57

Klassen voor het framework voor servicecontrole

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59

Hoofdstuk 10: Werken met native vensters Aanvullende online informatie over native vensters Basisinformatie over AIR-vensters Vensters maken Vensters beheren

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74

Luisteren naar venstergebeurtenissen

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81

Schermvullende vensters weergeven

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82

Hoofdstuk 11: Schermen Aanvullende online informatie over schermen Basisinformatie over schermen Schermen opsommen

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85

Hoofdstuk 12: Werken met native menu's Aanvullende online informatie over native menu's Basisinformatie over AIR-menu's Native menu's maken

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93

Informatie over contextmenu's

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94

Informatie over contextmenu's in HTML Native menu's declaratief definiëren Pop-upmenu's weergeven

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98

Menugebeurtenissen afhandelen

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98

Voorbeeld: venstermenu en toepassingsmenu

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100

Hoofdstuk 13: Taakbalkpictogrammen Aanvullende online informatie over taakbalkpictogrammen Informatie over taakbalkpictogrammen Dock-pictogrammen

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104

Systeemvakpictogrammen

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 105

Taakbalkpictogrammen en -knoppen voor vensters

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 107

Hoofdstuk 14: Werken met het bestandssysteem Aanvullende online informatie over de AIR API voor het bestandssysteem Basisinformatie over AIR-bestanden Werken met File-objecten

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 109

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 110

Informatie over het bestandssysteem ophalen Werken met mappen Werken met bestanden

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 109

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 119

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 119 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121

Lezen van en schrijven naar bestanden

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 124

Hoofdstuk 15: Slepen en neerzetten Aanvullende online informatie over slepen en neerzetten Basisinformatie over slepen en neerzetten

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 137

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 137

ONTWIKKELING VAN ADOBE AIR 1.5-TOEPASSINGEN MET FLASH CS4 PROFESSIONAL v Inhoud

Ondersteuning voor de uitsleepbeweging

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 139

Ondersteuning voor de insleepbeweging

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 142

HTML slepen en neerzetten

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 144

Hoofdstuk 16: kopiëren en plakken Aanvullende online informatie over kopiëren en plakken HTML kopiëren en plakken

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 153

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 154

Menuopdrachten en toetsaanslagen voor kopiëren en plakken

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 155

Hoofdstuk 17: Werken met bytearrays Bytearrays lezen en schrijven . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 159 Voorbeeld van een bytearray: een ZIP-bestand lezen

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 164

Hoofdstuk 18: Werken met lokale SQL-databases Aanvullende online informatie over lokale SQL-databases Informatie over lokale SQL-databases Databases creëren en wijzigen

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 169

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 170

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 174

Werken met SQL-databasegegevens

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 177

Synchrone en asynchrone databasebewerkingen gebruiken Codering gebruiken met SQL-databases

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 195

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 199

Strategieën voor het werken met SQL-databases

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 215

Hoofdstuk 19: Gecodeerde gegevens opslaan Hoofdstuk 20: Informatie over de HTML-omgeving Overzicht van de HTML-omgeving . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 222 AIR- en Webkit-extensies

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 225

Hoofdstuk 21: Programmeren in HTML en JavaScript Informatie over de klasse HTMLLoader . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 238 JavaScript-beveiligingsfouten voorkomen

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 240

API-klassen van AIR oproepen vanuit JavaScript Informatie over URL's in AIR

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 244

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 245

ActionScript-objecten beschikbaar maken voor JavaScript

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 246

HTML DOM- en JavaScript-objecten oproepen vanuit ActionScript SWF-inhoud insluiten in HTML

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 248

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 249

ActionScript-bibliotheken in een HTML-pagina gebruiken Date- en RegExp-objecten converteren

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 250

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 251

HTML-opmaakmodellen bewerken vanuit ActionScript

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 252

Cross-scripting van inhoud in verschillende beveiligingssandboxen

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 253

Hoofdstuk 22: HTML-gerelateerde gebeurtenissen afhandelen HTMLLoader-gebeurtenissen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 258 DOM-gebeurtenissen afhandelen met ActionScript

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 258

Reageren op niet-onderschepte JavaScript-uitzonderingen Runtimegebeurtenissen afhandelen met JavaScript

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 259

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 261

ONTWIKKELING VAN ADOBE AIR 1.5-TOEPASSINGEN MET FLASH CS4 PROFESSIONAL vi Inhoud

Hoofdstuk 23: Scripts schrijven voor de HTML-container Eigenschappen van HTMLLoader-objecten weergeven . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 264 HTML-inhoud schuiven

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 266

Historisch overzicht van HTML openen

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 267

Gebruikersagent voor het laden van HTML-inhoud instellen Tekencodering voor HTML-inhoud instellen

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 268

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 268

Gebruikersinterfaces van het type browser definiëren voor HTML-inhoud Subklassen van de klasse HTMLLoader maken

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 269

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 277

Hoofdstuk 24: PDF-inhoud toevoegen PDF-mogelijkheden detecteren . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 278 PDF-inhoud laden

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 279

Scripting van PDF-inhoud

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 279

Bekende beperkingen voor PDF-inhoud in AIR

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 281

Hoofdstuk 25: Digitaal rechtenbeheer gebruiken Aanvullende online informatie over digitaal rechtenbeheer Gecodeerde FLV-workflows begrijpen

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 283

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 284

Leden en gebeurtenissen van de klasse NetStream die betrekking hebben op DRM De klasse DRMStatusEvent gebruiken

De klasse DRMAuthenticateEvent gebruiken De klasse DRMErrorEvent gebruiken De klasse DRMManager gebruiken

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 288

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 290 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 291

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 292 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 295

De klasse DRMContentData gebruiken

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 296

Hoofdstuk 26: Opties voor het starten en sluiten van toepassingen Toepassingen oproepen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 297 Opdrachtregelargumenten vastleggen Starten bij aanmelden

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 298

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 300

Oproepen vanuit browser

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 300

Toepassingen beëindigen

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 302

Hoofdstuk 27: Toepassingsinstellingen lezen Het descriptorbestand van de toepassing lezen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 304 Toepassings- en uitgevers-id's ophalen

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 304

Hoofdstuk 28: Werken met runtime- en besturingssysteeminformatie Bestandskoppelingen beheren . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 306 De runtimeversie en het patchniveau ophalen AIR-mogelijkheden detecteren

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 307

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 307

Gebruikersaanwezigheid bijhouden

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 307

Hoofdstuk 29: Netwerkconnectiviteit bewaken Wijzigingen in de netwerkconnectiviteit detecteren Basisbeginselen van servicebewaking

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 309

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 309

HTTP-connectiviteit detecteren

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 310

Socketconnectiviteit detecteren

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 311

ONTWIKKELING VAN ADOBE AIR 1.5-TOEPASSINGEN MET FLASH CS4 PROFESSIONAL vii Inhoud

Hoofdstuk 30: URL-aanvragen en netwerken De klasse URLRequest gebruiken . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 312 Wijzigingen in de klasse URLStream

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 315

URL's openen in de standaard webbrowser van het systeem

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 316

Hoofdstuk 31: Communicatie tussen toepassingen Hoofdstuk 32: AIR-toepassingen distribueren, installeren en uitvoeren AIR-toepassingen vanaf de desktop installeren en uitvoeren . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 319 AIR-toepassingen installeren en uitvoeren vanaf een webpagina Implementatie in ondernemingen

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 320

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 328

AIR-bestanden digitaal ondertekenen

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 328

Hoofdstuk 33: AIR-toepassingen updaten Informatie over het updaten van toepassingen

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 336

Aangepaste gebruikersinterfaces voor toepassingsupdates presenteren AIR-bestanden naar de computer van de gebruiker downloaden

Controleren of een toepassing voor de eerste keer wordt uitgevoerd Het updateframework gebruiken

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 338

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 338 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 339

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 340

Hoofdstuk 34: AIR-toepassingen lokaliseren Inleiding tot lokalisatie . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 351 De toepassingsnaam en -beschrijving lokaliseren in het installatieprogramma van de toepassing

. . . . . . . . . . . . . . . . . . . . . . 351

Een landinstelling kiezen

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 352

Flash-inhoud lokaliseren

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 352

HTML-inhoud lokaliseren

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 353

Datums, tijden en valuta's lokaliseren

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 362

Hoofdstuk 35: AIR-toepassingen maken met behulp van opdrachtregelprogramma's ADL (AIR Debug Launcher) gebruiken . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 363 AIR-installatiebestanden in een pakket plaatsen met ADT (AIR Developer Tool) AIR-bestanden ondertekenen om het toepassingscertificaat te wijzigen Zelfondertekende certificaten maken met ADT

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 376

Apache Ant gebruiken met de hulpprogramma's van de SDK Index

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 365

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 375

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 377

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 381

1

Hoofdstuk 1: Adobe AIR installeren Adobe® AIR™ stelt u in staat AIR-toepassingen uit te voeren op de desktop. U kunt de runtime op de volgende manieren installeren:

• U kunt de runtime afzonderlijk installeren (zonder ook een AIR-toepassing te installeren). • U kunt voor de eerste keer een AIR-toepassing installeren (u wordt dan ook gevraagd de runtime te installeren). • U kunt een AIR-ontwikkelomgeving instellen zoals de AIR SDK, Adobe® Flex™ Builder™ 3 of de Adobe Flex™ 3 SDK (die de AIR-opdrachtregelhulpprogramma’s bevat). De runtime hoeft op iedere computer maar eenmaal te worden geïnstalleerd. Hier worden de systeemvereisten beschreven om AIR en AIR-toepassingen te installeren en uit te voeren: Adobe AIR: Systeemvereisten (http://www.adobe.com/products/air/systemreqs/).

Adobe AIR installeren Houd u aan de volgende instructies voor het downloaden en installeren van de Windows®, Mac OS X- en Linux-versies van AIR. Voor het updaten van de runtime moet de gebruiker over beheerdersrechten voor de computer beschikken. De runtime installeren op een Windows-computer 1 Download het runtime-installatiebestand. 2 Dubbelklik op het runtime-installatiebestand. 3 Volg in het installatievenster de aanwijzingen om de installatie te voltooien.

De runtime installeren op een Mac-computer 1 Download het runtime-installatiebestand. 2 Dubbelklik op het runtime-installatiebestand. 3 Volg in het installatievenster de aanwijzingen om de installatie te voltooien. 4 Als het installatieprogramma een verificatievenster weergeeft, geeft u uw gebruikersnaam en wachtwoord voor Mac

OS op. De runtime installeren op een Linux-computer 1 Download het runtime-installatiebestand. 2 Stel de bestandsmachtigingen in zodat de installatietoepassing kan worden uitgevoerd:

Via de opdrachtregel kunt u de bestandsmachtigingen instellen met de opdracht chmod +x installer.bin. Met bepaalde versies van Linux kunt u de bestandsmachtigingen instellen via het menu Eigenschappen dat u hebt geopend via een contextmenu. 3 Voer het installatieprogramma uit vanaf de opdrachtregel of door te dubbelklikken op het runtime-

installatiebestand. 4 Volg in het installatievenster de aanwijzingen om de installatie te voltooien.

ONTWIKKELING VAN ADOBE AIR 1.5-TOEPASSINGEN MET FLASH CS4 PROFESSIONAL 2 Adobe AIR installeren

AIR wordt geïnstalleerd als rpm- of dpkg-pakket met de pakketnaam: adobeairv.nen adobecerts. Voor de installatie is een in bedrijf zijnde X-server vereist. AIR registreert het mime-type: application/vnd.adobe.airapplication-installer-package+zip.

Adobe AIR verwijderen Wanneer u de runtime hebt geïnstalleerd, kunt u deze als volgt verwijderen. De runtime verwijderen op een Windows-computer 1 Klik in het menu Start van Windows op Instellingen > Configuratiescherm. 2 Selecteer het onderdeel Software. 3 Kies “Adobe AIR” om de runtime te verwijderen. 4 Klik op de knop Wijzigen/Verwijderen.

De runtime verwijderen op een Mac-computer • Dubbelklik op de “Adobe AIR Uninstaller” in de map /Applications/Utilities. De runtime verwijderen op een Linux-computer Ga als volgt te werk:

• Selecteer de opdracht om Adobe AIR te verwijderen in het menu Toepassingen. • Voer het AIR-installatieprogramma binair uit met de optie -uninstall • Verwijder de AIR-pakketten (adobeairv.n en adobecerts) via het pakketbeheer.

AIR-voorbeeldtoepassingen installeren en uitvoeren Er zijn een paar voorbeeldtoepassingen beschikbaar waarin functies van AIR worden gedemonstreerd. U kunt deze als volgt openen en installeren: 1 Download de AIR-voorbeeldtoepassingen en voer ze uit. Zowel de gecompileerde toepassingen als de broncode zijn

beschikbaar. 2 Als u een voorbeeldtoepassing wilt downloaden en uitvoeren, klikt u op de knop Install Now van de

voorbeeldtoepassing. U wordt gevraagd de toepassing te installeren en uit te voeren. 3 Als u voorbeeldtoepassingen wilt downloaden en later wilt uitvoeren, selecteert u de downloadkoppelingen. U kunt

AIR-toepassingen op elk gewenst moment uitvoeren:

• In Windows dubbelklikt u op het toepassingspictogram op het bureaublad of selecteert u de toepassing in het menu Start van Windows.

• In Mac OS dubbelklikt u op het toepassingspictogram dat standaard is geïnstalleerd in de map Applications (Programma’s) van de gebruikersdirectory (bijvoorbeeld in Macintosh HD/Users/Gebruiker/Applications/).

• In Linux dubbelklikt u op het toepassingspictogram op het bureaublad of selecteert u de toepassing in het menu Toepassingen. AIR-toepassingen worden geïnstalleerd in een aparte map onder de map /opt. Opmerking: Updates van de AIR-releasenotes vindt u in http://www.adobe.com/go/learn_air_relnotes_nl.

3

Hoofdstuk 2: Installatie van Flash CS3 voor Adobe AIR De Adobe® AIR™-update voor Adobe® Flash® CS3 Professional breidt de Flash-ontwikkelingsomgeving uit met elementen waarmee u AIR-toepassingen met behulp van Flash kunt bouwen. U kunt er AIR-toepassingsbestanden in Flash mee maken, testen en debuggen. Adobe® Flash® CS4 Professional heeft ingebouwde ondersteuning voor het maken van AIR-applicaties. Zie Publishing for Adobe AIRin Using Flash voor meer informatie. De Adobe AIR-update voor Flash CS3 ondersteunt AIR 1.0 en 1.1 en Flash Player 9.x. Flash CS4 is vereist voor het ontwikkelen van toepassingen met AIR 1.5 en Flash Player 10.

Systeemvereisten voor de Adobe AIR-update voor Flash CS3 Om Flash CS3 te gebruiken voor de ontwikkeling en uitvoering van AIR-toepassingen, moet de volgende software geïnstalleerd zijn:

• Flash CS3 Professional Indien u geen exemplaar hebt van Flash CS3 Professional kunt u dit aankopen op de Adobe-website: http://www.adobe.com/products/flash/

• Adobe AIR Raadpleeg “Adobe AIR installeren” op pagina 1 voor meer informatie over het installeren van Adobe AIR.

• Adobe AIR-update voor Flash CS3 Indien u al een versie van de Adobe AIR-update voor Flash CS3 hebt geïnstalleerd, moet u deze installatie eerst verwijderen door de procedure te volgen in Installatie van de Adobe AIR-update voor Flash CS3 ongedaan maken. Als u de Adobe AIR-update voor Flash CS3 nog niet eerder hebt geïnstalleerd, gaat u naar de sectie “Installatie van de Adobe AIR-update voor Flash CS3” op pagina 3.

Installatie van de Adobe AIR-update voor Flash CS3 Voordat u de Adobe AIR-update voor Flash CS3 installeert, sluit u Flash af en ook alle browsers die u mogelijk hebt geopend.

• Download de Adobe AIR-update voor Flash CS3. • Nadat u de update hebt gedownload, dubbelklikt u op het update patch-bestand om het te installeren.

ONTWIKKELING VAN ADOBE AIR 1.5-TOEPASSINGEN MET FLASH CS4 PROFESSIONAL 4 Installatie van Flash CS3 voor Adobe AIR

Installatie van de Adobe AIR-update voor Flash CS3 verwijderen Indien u de Adobe AIR-update voor Flash CS3 reeds hebt geïnstalleerd, voert u volgende stappen uit om de installatie te verwijderen alvorens een nieuwe Adobe AIR-update voor Flash CS3 te installeren. 1 Verwijder volgende map:

(Windows) HD:\Program Files\Adobe\Adobe Flash CS3\AIK (Mac) HD:/Applications/Adobe Flash CS3/AIK 2 Zoek volgende locatie:

(Windows) HD:\Program Files\Adobe\Adobe Flash CS3\\First Run\Commands\ (Mac) HD:/Applications/Adobe Flash CS3/First Run/Commands en verwijder de volgende bestanden/mappen:

• AIR-map • AIR - Application and Installer Settings.jsfl • AIR - Create AIR File.jsfl 3 Verwijder volgend bestand:

(Windows) HD:\Program Files\Adobe\Adobe Flash CS3\\Configuration\External Libraries\FLAir.dll (Mac) HD:/Applications/Adobe Flash CS3/Configuration/External Libraries/FLAir.bundle. 4 Verwijder het volgende bestand:

(Windows) HD:\Program Files\Adobe\Adobe Flash CS3\\Configuration\Players\AdobeAIR1_0.xml (Mac) HD:/Applications/Adobe Flash CS3/Configuration/Players/ AdobeAIR1_0.xml 5 Zoek de volgende locatie:

(Windows) HD:\Document and Settings\<username>\Local Settings\Application Data\Adobe\Flash CS3\\Configuration\Commands\ (Mac) HD:/Users/<username>/Library/Application Support/Adobe/Flash CS3//Configuration/Commands/ en verwijder de volgende bestanden/mappen:

• AIR-map • AIR - Application and Installer Settings.jsfl • AIR - Create AIR File.jsfl Opmerking: Als u de opgegeven locatie niet vindt in Windows schakelt u "Verborgen bestanden/mappen weergeven" in de mapopties in.

ONTWIKKELING VAN ADOBE AIR 1.5-TOEPASSINGEN MET FLASH CS4 PROFESSIONAL 5 Installatie van Flash CS3 voor Adobe AIR

AIR-uitbreidingen van Flash CS3 Na het installeren van de Adobe AIR-update kunt u volgende wijzigingen zien in Flash:

• In het dialoogvenster Publicatie-instellingen (Bestand -> Publicatie-instellingen), op het tabblad Flash, is er een nieuwe ingang in het menu Versie voor Adobe AIR 1.0

• Een bijgewerkt welkomscherm dat een ingang bevat voor het aanmaken van een Flash-bestand (Adobe AIR) (Windows) HD:\Program Files\Adobe\Adobe Flash CS3\en\FirstRun\StartPage (Windows) HD:\Program Files\Adobe\Adobe Flash CS3\en\FirstRun\StartPage\resources Opmerking: Op een MacIntosh-computer, verwijdert u de volgende map als het Flash-bestand (Adobe AIR) niet wordt weergegeven in het welkomscherm en start u Flash opnieuw op: HD:/Users/<username>/Libraries/Application Support/Adobe/Flash CS3//Configuration/StartPage

• Nieuw playerglobal.swc-bestand dat alle ActionScript 3.0 API's en Adobe AIR API's omvat in de map ActionScript 3.0/Classes (Windows) HD:\Program Files\Adobe\Adobe Flash CS3\en\Configuration\ActionScript 3.0 Classes (Mac) HD:/Applications/Adobe Flash CS3/Configuration/ActionScript 3.0/Classes/

• Nieuwe jsfl-bestanden (AIR - Application and Installer Settings.jsfl, AIR - Publish AIR File.jsfl) (Windows) HD:\Program Files\Adobe\Adobe Flash CS3\en\FirstRun\Commands (Mac) HD:/Applications/Adobe Flash CS3/First Run/Commands/

• Adobe AIR Software Development Kit (AIK) (Windows) HD:\Program Files\Adobe\Adobe Flash CS3\AIK

• Externe bibliotheek (Windows) HD:\Program Files\Adobe\Adobe Flash CS3\en\Configuration\External Libraries (Mac) HD:/Applications/Adobe Flash CS3/Configuration/External Libraries/

• Doelbestand voor configuratie (Windows) HD:\Program Files\Adobe\Adobe Flash CS3\en\Configuration\Players\ (Mac) HD:/Applications/Adobe Flash CS3/Configuration/Players

6

Hoofdstuk 3: Inleiding tot Adobe AIR Adobe® AIR™ is besturingssysteem overschrijdende runtime waarmee u uw bestaande webontwikkelingsvaardigheden kunt optimaliseren (Adobe® Flash® CS3 Professional, Adobe® Flash® CS4 Professional, Adobe® Flex™, Adobe® ActionScript® 3.0, HTML, JavaScript®, Ajax) om RIA's (Rich Internet Applications) te maken en te implementeren voor het bureaublad. Meer informatie over hoe u aan de slag gaat met en werkt met Adobe AIR vindt u op de Adobe AIR Developer Connection (http://www.adobe.com/devnet/air/). AIR stelt u in staat te werken in bekende omgevingen, gebruik te blijven maken van de hulpmiddelen en benaderingen die u goed kent en zo, mede dankzij de ondersteuning van Flash, Flex, HTML, JavaScript en Ajax, toepassingen te bouwen die optimaal aansluiten bij uw behoeften. U kunt bijvoorbeeld toepassingen ontwikkelen met behulp van een van de volgende technologieën of een combinatie daarvan:

• Flash / Flex / ActionScript • HTML / JavaScript / CSS / Ajax • PDF kan worden gebruikt met iedere toepassing. AIR-toepassingen kunnen daarom worden gebaseerd op:

• Flash of Flex: toepassingen waarvan de basisinhoud bestaat uit Flash/Flex (SWF); • Flash of Flex met HTML of PDF: toepassingen waarvan de basisinhoud bestaat uit Flash/Flex (SWF) met HTML(HTML, JS, CSS) of PDF-inhoud;

• HTML: toepassingen waarvan de basisinhoud bestaat uit HTML, JS, CSS; • HTML met Flash/Flex of PDF: toepassingen waarvan de basisinhoud bestaat uit HTML met Flash/Flex- (SWF) of PDF-inhoud. Gebruikers gebruiken AIR-toepassingen op dezelfde manier als native desktoptoepassingen. De runtime wordt éénmaal op de computer van de gebruiker geïnstalleerd, en daarna worden AIR-toepassingen geïnstalleerd en uitgevoerd net als elke andere desktoptoepassing. De runtime biedt een consistent platform voor meerdere besturingssystemen en een kader voor de implementatie van toepassingen waarbij de functionaliteit op verschillende desktops gegarandeerd constant is, zodat deze niet voor elke browser hoeft te worden getest. U richt zich bij de ontwikkeling op de runtime, niet op een specifiek besturingssysteem. Dit heeft de volgende voordelen:

• Toepassingen die zijn ontwikkeld voor AIR kunnen in meerdere besturingssystemen worden uitgevoerd zonder dat u extra werk hoeft te verrichten. De runtime garandeert een consistente en voorspelbare presentatie en interacties voor alle besturingssystemen die worden ondersteund door AIR.

• U kunt veel sneller toepassingen bouwen doordat u in staat bent gebruik te maken van bestaande webtechnologieën en ontwerppatronen, en doordat u uw webgebaseerde toepassingen kunt uitbreiden naar de desktop zonder dat u de traditionele technologieën voor desktopontwikkeling hoeft te leren of zich bezig hoeft te houden met de complexiteit van native code.

• Bij de ontwikkeling van toepassingen hoeft u geen gebruik te maken van laag-niveautalen zoals C of C++. U hoeft niet de complexe laag-niveau-API's te beheren die specifiek zijn voor ieder besturingssysteem.

ONTWIKKELING VAN ADOBE AIR 1.5-TOEPASSINGEN MET FLASH CS4 PROFESSIONAL 7 Inleiding tot Adobe AIR

Bij de ontwikkeling van toepassingen voor AIR kunt u gebruikmaken van een zeer uitgebreide set bestaande frameworks en API's:

• API's die specifiek zijn voor AIR en die worden geleverd door de runtime en het AIR-framework • ActionScript-API's die worden gebruikt in SWF-bestanden en Flex-frameworks (evenals andere ActionScriptgebaseerde bibliotheken en frameworks)

• HTML, CSS en JavaScript • De meeste Ajax-frameworks AIR zorgt voor een enorme verandering in de manier waarop toepassingen kunnen worden gemaakt, geïmplementeerd en ervaren. U krijgt meer creatieve controle en kunt uw Flash-, Flex-, HTML- en Ajax-gebaseerde toepassingen uitbreiden naar de desktop zonder dat u de traditionele desktopontwikkeltechnologieën hoeft te leren.

Nieuw in AIR 1.1 Adobe AIR 1.1 heeft de volgende nieuwe functies geïntroduceerd:

• Installatiedialoogvensters en andere runtime dialoogvensters zijn vertaald naar de volgende talen: • Portugees (Braziliaans) • Chinees (Traditioneel en Vereenvoudigd) • Frans • Duits • Italiaans • Japans • Koreaans • Russisch • Frans • Spaans • Ondersteuning voor het maken van internationale toepassingen, waaronder toetsenbordinvoer voor doublebytetalen. Zie “AIR-toepassingen lokaliseren” op pagina 351.

• Ondersteuning voor de vertaling van de naam- en beschrijvingskenmerken in het toepassingsdescriptorbestand. • Ondersteuning voor de vertaling van foutberichten, zoals SQLError.detailID en SQLError.detailArguments, in de SQLite-database.

• Toevoeging van de eigenschap Capabilities.languages om een array met voorkeurstalen voor de gebruikersinterface te verkrijgen zoals deze door het besturingssysteem zijn ingesteld.

• HTML-knoplabels en standaardmenu's, zoals snelmenu's en de Mac-menubalk, zijn vertaald naar alle ondersteunde talen.

• Ondersteuning voor certificaatmigratie van een zelfondertekende toepassing naar een toepassing die is gekoppeld aan een certificeringsinstantie (CA).

• Ondersteuning voor Microsoft Windows XP Tablet PC Edition en ondersteuning voor de 64-bits edities van Windows Vista® Home Premium, Business, Ultimate of Enterprise.

• Toevoeging van File.spaceAvailable-API om op te halen hoeveel schijfruimte beschikbaar is op een schijf.

ONTWIKKELING VAN ADOBE AIR 1.5-TOEPASSINGEN MET FLASH CS4 PROFESSIONAL 8 Inleiding tot Adobe AIR

• Toevoeging van de eigenschap NativeWindow.supportsTransparency om te bepalen of een venster door het huidige besturingssysteem als transparant kan worden getekend. Voor meer informatie over de AIR 1.1-versie raadpleegt u de Adobe AIR 1.1 Release-notities (http://www.adobe.com/go/learn_air_relnotes_nl).

Nieuw in AIR 1.5 Adobe AIR 1.5 heeft de volgende nieuwe functies geïntroduceerd:

• Ondersteuning voor de volgende functies van Flash Player 10. • Aangepaste filters en effecten • Uitgebreide teken-API • Dynamisch genereren van geluid • Gegevenstype Vector • Uitgebreide API's voor het uploaden en downloaden van bestanden • Real Time Media Flow Protocol (RTMFP) • 3D-effecten • Geavanceerde tekstondersteuning • Kleurbeheer • Tekstengine • Dynamische streaming • Speex-audiocodec Op http://www.adobe.com/products/flashplayer/features/ vindt u meer details over deze functies.

• Er worden meer talen ondersteund in het installatieprogramma en andere runtime dialoogvensters van AIR 1.5: Tsjechisch, Nederlands, Zweeds, Turks, Pools.

• Databasecodering. Databasebestanden kunnen in AIR 1.5 worden gecodeerd. Alle database-inhoud, inclusief de metagegevens, kan zo worden gecodeerd dat de gegevens onleesbaar zijn buiten de AIR-toepassing waarin ze zijn gecodeerd. Met deze functie kan een ontwikkelaar databasebestanden coderen, decoderen en opnieuw coderen. Zie “Gecodeerde gegevens opslaan” op pagina 220.

• De versie van WebKit die door Adobe AIR wordt gebruikt, is bijgewerkt, en bevat nu ondersteuning voor de JavaScript-interpreter SquirrelFish.

• Nieuwe XML-API's voor handtekeningvalidatie kunnen worden gebruikt om de integriteit en de identiteit van de ondergetekende van de gegevens of informatie te controleren. Zie XML-handtekeningvalidatie. Voor meer informatie over de AIR 1.5-versie raadpleegt u de Adobe AIR 1.5 Release-notities (http://www.adobe.com/go/learn_air_relnotes_nl).

9

Hoofdstuk 4: AIR-bronnen zoeken Raadpleeg de volgende bronnen voor meer informatie over het ontwikkelen van Adobe® AIR™-toepassingen: Bron

Locatie

ActionScript 3.0 programmeren

http://www.adobe.com/go/learn_fl_cs4_programmingAS3_en

ActionScript 3.0 Language and Components Reference (bevat AIR)

http://www.adobe.com/go/learn_flashcs4_langref_en

Adobe AIR-snelstarthandleidingen voor Flash

http://www.adobe.com/go/learn_air_flash_qs_nl

Flash gebruiken

http://www.adobe.com/go/learn_fl_cs4_using_en

ActionScript 3.0-componenten gebruiken

http://www.adobe.com/go/learn_fl_cs4_as3components_en

Artikelen, voorbeelden en presentaties door Adobe en community-specialisten kunt u vinden in Adobe AIR Developer Connection op http://www.adobe.com/devnet/air/. Hier kunt u ook Adobe AIR en verwante software downloaden. Een sectie speciaal voor Flash-ontwikkelaars kunt u vinden op http://www.adobe.com/devnet/air/flash/. Bezoek de Adobe-ondersteuningssite op http://www.adobe.com/support/ om problemen met uw product op te lossen en alles te leren over gratis en betaalde technische ondersteuningsmogelijkheden. Volg de koppeling Training voor toegang tot boeken van Adobe Press, uiteenlopende opleidingsbronnen, certificeringsprogramma's voor Adobesoftware en nog veel meer.

10

Hoofdstuk 5: Uw eerste AIR-applicatie maken met Flash CS3 of CS4 Voor een snelle, praktische demonstratie van de werking van Adobe® AIR™ volgt u de aanwijzingen in dit onderwerp om een eenvoudige “Hello World” AIR-toepassing te maken en te comprimeren met Adobe® Flash® CS3 Professional. Download en installeer de Adobe AIR-update voor Flash CS3 mocht u dit nog niet hebben gedaan. Voor meer informatie over de installatie van Adobe AIR voor Flash CS3, kunt u “Installatie van Flash CS3 voor Adobe AIR” op pagina 3 raadplegen. Als u Adobe® Flash® CS4 Professional gebruikt, is ondersteuning voor Adobe AIR al ingebouwd, zodat u niets hoeft te installeren om aan de slag te gaan.

De Hello World-toepassing in Flash maken Een Adobe AIR-toepassing in Flash maken, is vergelijkbaar met het maken van iedere andere FLA-toepassing. In dit geval begint u echter met het maken van een Flash-bestand (Adobe AIR) vanuit het welkomscherm en u eindigt met het aanmaken van de toepassings- en installer-instellingen, en het installeren van uw AIR-toepassing. De volgende procedure leidt u door het aanmaakproces van een eenvoudige Hello World-toepassing met behulp van Flash CS3 of Flash CS4. De Hello World-toepassing aanmaken 1 Start Flash. 2 In het welkomscherm klikt u op Flash-bestand (Adobe AIR) om een leeg FLA-bestand aan te maken met Adobe

AIR-publicatie-instellingen. 3 Klik op OK om te reageren op het overzichtsdialoogvenster, Ontwerpomgeving voor Adobe AIR met Flash CS3.

Het duurt de eerste keer een paar minuten voordat dit dialoogvenster verschijnt. (Dit dialoogvenster wordt niet weergegeven in Flash CS4.) 4 Selecteer Tekstgereedschap in het venster Gereedschappen en maak een statisch tekstveld (standaard) in het

midden van de stage. Maak het breed genoeg zodat het 15 -20 tekens kan bevatten. 5 Typ de tekst “Hello World” in het tekstveld. 6 Sla het bestand op met een naam (bijvoorbeeld, helloAIR).

De toepassing testen 1 Druk op Ctrl + Enter of selecteer Control ->Test Movie om de toepassing te testen in Adobe AIR. 2 Om de functie Debug Movie te gebruiken, voegt u eerst de ActionScript-code toe aan de toepassing. U kunt dit snel

proberen door als volgt een trace statement toe te voegen: trace("Running AIR application using Debug Movie");

3 Druk op Ctrl + Shift + Enter, of selecteer Control->Debug Movie om de toepassing met Debug Movie uit te voeren.

ONTWIKKELING VAN ADOBE AIR 1.5-TOEPASSINGEN MET FLASH CS4 PROFESSIONAL 11 Uw eerste AIR-applicatie maken met Flash CS3 of CS4

4 Selecteer Commands > AIR - toepassingen en Installer-instellingen om het dialoogvenster AIR - Toepassing &

Installer-instellingen te openen. In Flash CS4 kunt u dit dialoogvenster openen door Bestand > AIR-instellingen te kiezen.

5 Onderteken het Adobe AIR-pakket met een zelfondertekend digitaal certificaat: a Klik op de knop Instellen… zodat de prompt Digitale handtekening het dialoogvenster Digitale handtekening

kan openen. b Klik op de knop Maken... om het dialoogvenster Zelfondertekend digitaal certificaat maken te openen c Vul de volgende velden in: Naam uitgever, Afdeling organisatie, Naam organisatie, E-mail, Land, Wachtwoord,

en Wachtwoord bevestigen. d Geef het soort certificaat op. Het soort certificaat houdt verband met het niveau van beveiliging: 1024-RSA

gebruikt een 1024-bit-code (minder veilig), en 2048-RSA gebruikt een 2048-bit-code (veiliger). e Sla de gegevens op in een certificaatbestand via Opslaan als, of door te klikken op de knop Bladeren... om naar

een maplocatie te gaan. (Bijvoorbeeld, C:/Temp/mycert.pfx). Klik als u klaar bent op OK. f

Flash leidt u terug naar het dialoogvenster Digitale handtekening. Het pad en de bestandsnaam van het zelfondertekende certificaat dat u hebt gemaakt, verschijnt in het tekstvak Certificaat. Indien dit niet het geval is, voert u het pad en de bestandsnaam in of klikt u op de knop Bladeren om het te zoeken en te selecteren.

ONTWIKKELING VAN ADOBE AIR 1.5-TOEPASSINGEN MET FLASH CS4 PROFESSIONAL 12 Uw eerste AIR-applicatie maken met Flash CS3 of CS4

g Typ hetzelfde wachtwoord als in stap c in het tekstveld Wachtwoord van het dialoogvenster Digitale

handtekening en klik op OK. Voor meer informatie over het ondertekenen van uw Adobe AIR-toepassingen raadpleegt u “Uw toepassing ondertekenen” op pagina 21. 6 Om het toepassings- en installerbestand aan te maken, klikt u op de knop AIR-bestand publiceren. U moet Test

Movie of Debug Movie uitvoeren om het SWF-bestand en de .xml-bestanden van de toepassing aan te maken voordat u het AIR-bestand aanmaakt. 7 Om de toepassing te installeren, dubbelklikt u op het AIR-bestand (toepassing.air) in dezelfde map waarin u uw

toepassing hebt opgeslagen. 8 Klik op de knop Installeren in het dialoogvenster Toepassing installeren. 9 Controleer de installatievoorkeuren en de locatie-instellingen en zorg dat het vakje ‘Toepassing opstarten na

installatie’ is aangevinkt. Klik vervolgens op Doorgaan. 10 Als het bericht Installatie voltooid verschijnt, klikt u op Afsluiten.

De toepassing Hello World ziet er als volgt uit:

Een FLA-toepassing converteren naar een Adobe AIRtoepassing U kunt een bestaand FLA-bestand ook converteren naar een AIR-toepassing. Voor meer informatie raadpleegt u “Adobe AIR-publicatie-instellingen installeren” op pagina 13. Als u Flash CS4 gebruikt, zie dan Publishing for Adobe AIRin Using Flash voor meer informatie.

13

Hoofdstuk 6: Adobe AIR-update voor Flash CS3 Professional De Adobe® AIR™-update voor Adobe® Flash® CS3 Professional vult de ontwerpomgeving aan waardoor u Adobe AIRtoepassingen met Flash kunt aanmaken, debuggen en comprimeren. De procedure voor het aanmaken van een Adobe AIR-toepassing bestaat uit het creëren van een Adobe AIR FLA-bestand, het installeren van de juiste publicatieinstellingen, het ontwikkelen van de toepassing, en het aanmaken van de toepassings- en installer-bestanden zodat u met de bestanden kunt werken. Als u Adobe® Flash® CS4 Professional gebruikt, kunt u naar Publishing for Adobe AIRin Using Flash gaan voor meer informatie over AIR-toepassingen. Voor informatie over de Adobe AIR ActionScript®3.0 API's die u kunt gebruiken in uw toepassing, raadpleegt u op de verwijzing ActionScript 3.0 Taal en Componenten. Voor een lijst met Adobe AIR ActionScript API's raadpleegt u “Functionaliteit die specifiek is voor Adobe AIR” op pagina 55. Opmerking: Om gebruik te maken van klassen in het air.net-pakket, sleept u eerst het ServiceMonitorShim -component vanuit het venster Componenten naar het venster Bibliotheek en voegt u vervolgens de volgende import-verklaring toe aan uw ActionScript 3.0-code: import air.net.*;

Een Adobe AIR-bestand aanmaken U kunt Flash-bestanddocumenten (Adobe AIR) aanmaken met behulp van het Flash-welkomscherm of een Flashbestand aanmaken (ActionScript 3.0) en dit converteren naar een Adobe AIR-bestand via het dialoogvenster Publicatie-instellingen. U kunt echter geen Adobe AIR-bestand aanmaken met het dialoogvenster Nieuw document (Bestand > Nieuw). Voor informatie over het converteren van een FLA-bestand naar een Adobe AIR-bestand, raadpleegt u “Adobe AIR-publicatie-instellingen installeren” op pagina 13. 1 Start Flash of, indien Flash reeds opgestart is, sluit u alle openstaande documenten om terug te keren naar het

welkomscherm. Opmerking: Als u het Flash-welkomscherm hebt uitgeschakeld, kunt u het opnieuw weergeven door Bewerken > Voorkeuren selecteren en Welkomscherm kiezen in het pop-upmenu On Launch van de rubriek Algemeen. 2 In het welkomscherm klikt u op Flash-bestand (Adobe AIR).

Er verschijnt een waarschuwingsbericht waarin wordt gemeld hoe u de Adobe AIR-toepassingsinstellingen en de Help-documentatie kunt openen. U kunt dit waarschuwingsbericht in het vervolg overslaan door het selectievakje Niet meer weergeven in te schakelen, maar er is geen manier om het daarna opnieuw te laten weergeven.

Adobe AIR-publicatie-instellingen installeren Gebruik de Flash-publicatie-instellingen om de instellingen voor een AIR-bestand te onderzoeken en te wijzigen en om een Flash-bestandsdocument (ActionScript 3.0) naar een Flash-bestandsdocument (Adobe AIR) te converteren.

ONTWIKKELING VAN ADOBE AIR 1.5-TOEPASSINGEN MET FLASH CS4 PROFESSIONAL 14 Adobe AIR-update voor Flash CS3 Professional

Adobe AIR-publicatie-instellingen weergeven 1 Open vanuit het Flash-welkomscherm een Flash-bestandsdocument (Adobe AIR). 2 Selecteer Bestand > Publicatie-instellingen en klik op het tabblad Flash om de Adobe AIR-publicatie-instellingen

weer te geven. Adobe AIR 1.0 wordt automatisch geselecteerd in het menu Versie wanneer u een Adobe AIR-document opent. De versie van ActionScript wordt automatisch ingesteld op ActionScript 3.0. De instelling Lokale afspeelbeveiliging is gedimd, omdat deze irrelevant is voor een AIR SWF-bestand. Als u een Flash FLA-bestand heeft geopend, kunt u dit converteren naar een Flash AIR-bestand door de publicatieinstellingen te wijzigen. Een Flash FLA-bestand converteren naar een Flash AIR-bestand met behulp van het dialoogvenster Publicatieinstellingen 1 Ga als volgt te werk:

• Open een bestaand FLA-bestand. • Gebruik het welkomscherm of selecteer Bestand > Nieuw om een FLA-bestand aan te maken. 2 Selecteer Bestand > Publicatie-instellingen. 3 Op het tabblad Flash selecteert u in het pop-upmenu Versie Adobe AIR 1.0.

De versie ActionScript is uitgeschakeld omdat ActionScript 3.0 de enige optie is voor een AIR-bestand. De resterende standaardopties zijn gelijk voor zowel een FLA-bestand als een Adobe AIR-bestand. 4 Klik op de knop Publiceren, en klik vervolgens op OK om het dialoogvenster Publicatie-instellingen af te sluiten.

De Property inspector geeft nu aan dat Adobe AIR 1 de Player target is als het gereedschap Selectie is geselecteerd. Opmerking: Wanneer u het Adobe AIR 1.0-profiel kiest, voegt Flash automatisch de locatie van het AIR playerglobal.swc-bestand toe aan de Classpath-omgevingsvariabele. Het AIR playerglobal.swc-bestand biedt u de mogelijkheid om de ActionScript AIR API's te gebruiken. Als u overschakelt van Adobe AIR 1 naar Adobe® Flash® Player 9 wordt Flash echter niet automatisch in het standaardprofiel ingesteld, of wordt de Classpath-instelling niet gewijzigd om de playerglobal.swc voor Flash Player 9 te gebruiken. Als u de publicatie-instellingen van Adobe AIR 1 naar Flash Player 9 wijzigt, moet u het publicatieprofiel instellen als standaard. Voor meer informatie over het dialoogvenster Publicatie-instellingen, raadpleegt u Flash gebruiken op www.adobe.com/go/learn_fl_using. Een Flash FLA-bestand converteren naar een Flash AIR-toepassing met behulp van het menu Opdrachten 1 Open uw Flash FLA-bestand. 2 Als u een nieuw Flash-bestand (ActionScript 3.0) opent, moet u het opslaan. Als u het niet opslaat, verschijnt er een

waarschuwing bij de volgende stap. 3 Selecteer Opdrachten > AIR - Toepassings- en Installer-instellingen.

Er verschijnt een waarschuwingsbericht waarin u wordt gevraagd of u het bestand wilt converteren naar Adobe AIR-publicatie-instellingen. 4 Klik op OK om het FLA-bestand te converteren naar Adobe AIR-publicatie-instellingen. Het dialoogvenster AIR -

Toepassings- en Installer-instellingen wordt weergegeven. Voor informatie over het dialoogvenster AIR - Toepassings- en Installer-instellingen raadpleegt u “AIRtoepassings- en installerbestanden aanmaken” op pagina 16.


U kunt gebruikmaken van de opdrachten Film testen, Film debuggen, en AIR-bestand aanmaken op het geconverteerde AIR FLA-bestand.

Voorbeeld van een Adobe AIR-toepassing U kunt een voorbeeld bekijken van een Flash AIR SWF-bestand zoals het zal worden weergegeven in het AIRtoepassingsvenster. Een voorbeeld is nuttig wanneer u wilt zien hoe de zichtbare aspecten van de toepassing eruitzien zonder de toepassing te comprimeren en te installeren. 1 Zorg dat u de publicatie-instellingen hebt ingesteld voor een Adobe AIR-toepassing. Voor meer informatie

raadpleegt u “Adobe AIR-publicatie-instellingen installeren” op pagina 13. 2 Selecteer Beheer > Film testen of druk op Control+Enter.

Als u de toepassingsinstellingen niet hebt ingesteld via het dialoogvenster AIR - Toepassings- en Installerinstellingen genereert Flash voor u een descriptor-bestand in de standaardtoepassing (swfname-app.xml) in dezelfde map als de map waarin het SWF-bestand is geschreven. Als u de toepassingsinstellingen hebt ingesteld via het dialoogvenster AIR - Toepassings- en Installer-instellingen, geeft het descriptor-bestand van de toepassing die instellingen weer.

Het debuggen van een Adobe AIR-toepassing Het Adobe AIR SWF-bestand kan op dezelfde wijze worden gedebugged als een Flash Player 9 ActionScript 3.0 SWFbestand, behalve voor debuggen op afstand. 1 Zorg dat u de Adobe AIR-publicatie-instellingen hebt ingesteld. 2 Voeg de ActionScript-code toe aan het venster Acties (Window > Acties). Voor testing kunt u gewoon een trace()

statement zoals deze in het venster Acties toevoegen op het eerste frame van de Tijdslijn: trace("My application is running");

3 Selecteer Debuggen > Film debuggen of druk op Control+Shift+Enter.

Flash opent de ActionScript-debugger en exporteert het SWF-bestand met de debug-gegevens. Als u de toepassingsinstellingen niet hebt ingesteld via het dialoogvenster AIR - Toepassings- en Installerinstellingen genereert Flash voor u een descriptor-bestand in de standaardtoepassing (swfname-app.xml) in dezelfde map als de map waarin het SWF-bestand is geschreven. Als u de toepassingsinstellingen hebt ingesteld via het dialoogvenster AIR - Toepassings- en Installer-instellingen, geeft het descriptor-bestand van de toepassing die instellingen weer. Wanneer u Debuggen > Film debuggen selecteert of u drukt op Control+Shift+Enter om uw toepassing te debuggen, geeft Flash een waarschuwing weer als uw toepassing geen ActionScript-code heeft ingevoegd.


AIR-toepassings- en installerbestanden aanmaken Nadat u uw toepassing hebt voltooid, maakt u de AIR-toepassing en de installer-bestanden aan om deze te gebruiken. Adobe AIR voegt twee nieuwe menu's toe aan het Flash-opdrachtenmenu: AIR - Toepassings- en Installer-instellingen en AIR - AIR-bestand aanmaken. Nadat u de AIR-toepassing en installer-instellingen hebt aangemaakt, kunt u gebruikmaken van het item AIR-AIR-bestand aanmaken om het AIR-bestand (.air) opnieuw aan te maken met de bestaande instellingen. De Adobe AIR-toepassings- en installer-betanden aanmaken 1 In Flash opent u de pagina's of groep van pagina's die uw Adobe AIR-toepassing vormen. 2 Sla het Adobe AIR FLA-bestand op voordat u het dialoogvenster AIR - Toepassings- en Installer-instellingen opent. 3 Selecteer Opdrachten > AIR - Toepassings- en Installer-instellingen. 4 Vul het dialoogvenster AIR - Toepassings- en Installer-instellingen in, en klik vervolgens op AIR-bestand

publiceren. Als u klikt op de knop AIR-bestand publiceren worden de volgende bestanden gecomprimeerd: het FLA-bestand, het SWF-bestand, het descriptor-bestand van de toepassing, de bestanden van het toepassingspictogram, en de bestanden die worden weergegeven in het tekstvak Toegevoegde bestanden. Als u nog geen digitaal certificaat hebt aangemaakt, geeft Flash het dialoogvenster Digitale handtekening weer wanneer u op de knop AIR-bestand publiceren, klikt. Het dialoogvenster AIR - Toepassings en Installer-instellingen bestaat uit twee onderdelen: Toepassingsinstellingen en Installer-instellingen. Zie de volgende secties voor meer informatie over deze instellingen.

Toepassingsinstellingen De sectie toepassingsinstellingen van het dialoogvenster AIR - Toepassings- en Installer-instellingen heeft de volgende opties: Bestandsnaam De naam van het hoofdbestand van de toepassing. Standaardinstellingen voor de naam van het SWF-

bestand. Naam De naam die wordt gebruikt door de installer voor het genereren van de bestandsnaam van de toepassing en de

toepassingsmap. De naam mag enkel geldige tekens voor bestandsnamen of namen van mappen bevatten. Standaardinstellingen voor de naam van het SWF-bestand. Versie Optioneel. Geeft het versienummer op voor uw toepassing. Standaardinstelling is leeg. Id Identificeert uw toepassing met een unieke id. U kunt de standaard-id wijzigen als u dit wenst. Gebruik geen spaties of speciale tekens in de id. De enige geldige tekens zijn 0-9, a-z, A-Z, . (punt), en - (koppelteken), van 1 tot 212 tekens lang. Is standaard ingesteld op com.adobe.voorbeeld.toepassing_naam. Beschrijving Optioneel. Hiermee kunt u een beschrijving invoeren van de toepassing die wordt weergegeven wanneer de gebruiker de toepassing installeert. Standaardinstelling is leeg. Copyright Optioneel. Hiermee kunt u een copyright-melding invoeren die wordt weergegeven wanneer de gebruiker

de toepassing installeert. Vensterstijl Geeft aan welke vensterstijl (of chroom) u moet gebruiken voor de gebruikersinterface wanneer de gebruikers de toepassing uitvoeren op hun computer. U kunt Systeemchroom opgeven. Dit verwijst naar de visuele stijl die wordt gebruikt door het besturingssysteem. U kunt ook Aangepaste chroom (ondoorzichtig) of Aangepaste chroom (transparant) opgeven. Om uw toepassing zonder de systeemchroom weer te geven, selecteert u Geen. Systeemchroom omringt de toepassing met het standaard vensterbeheer van het besturingssysteem. Aangepaste


chroom (ondoorzichtig) elimineert de chroom van het standaardsysteem en laat u een eigen chroom creëren voor de toepassing. (U bouwt de aangepaste chroom rechtstreeks in het FLA-bestand.) Aangepaste chroom (transparant) is als Aangepaste chroom (ondoorzichtig), behalve dat het transparante capaciteiten toevoegt aan de randen van de pagina. Deze capaciteiten laten toepassingsvensters toe die niet vierkant of rechthoekig zijn. Pictogram Optioneel. Hiermee kunt u een pictogram voor de toepassing specificeren. Het pictogram wordt weergegeven nadat u de toepassing hebt geïinstalleerd en uitgevoerd in Adobe AIR. U kunt vier verschillende groottes opgeven voor het pictogram (128, 48, 32, en 16 pixels) om de verschillende weergaven waarin het pictogram verschijnt mogelijk te maken. Bijvoorbeeld, het pictogram kan worden weergegeven in de bestandsbrowser als thumbnail, gedetailleerd en naast elkaar. Het kan ook als bureaubladpictogram worden weergegeven, en in de titel van het AIRtoepassingsvenster, alsook op andere plaatsen.

De pictogramafbeelding is standaard ingesteld als een voorbeeld van een AIR-toepassingspictogram als er geen andere pictogrambestanden zijn opgegeven. Om een pictogram op te geven, klikt u op de knop Pictogramafbeeldingen selecteren in het To specify an icon, click the Select Icon Images button in het dialoogvenster AIR - Toepassings- en Installer-instellingen. In het dialoogvenster van de pictogramafbeeldingen dat wordt weergegeven, klikt u op de map voor elke pictogramgrootte en selecteert u het pictogrambestand dat moet worden gebruikt. De bestanden moeten in PNG-formaat (Portable Network Graphics) zijn. Volgende illustraties geven het dialoogvenster weer van de pictogramafbeeldingen met de standaard Adobe AIRtoepassingspictogrammen.

Verschillende groottes van de pictogramafbeeldingen van de toepassing opgeven

Als u een afbeelding opgeeft, moet het de exacte grootte hebben (128x128, 48x48, 32x32, of 16x16). Als u geen afbeelding opgeeft voor een bepaalde pictogramgrootte, past Adobe AIR een van de meegeleverde afbeeldingen aan om de ontbrekende pictogramafbeelding aan te maken.


Geavanceerde instellingen Met de knop Instellingen in het dialoogvenster AIR - Toepassings- en Installer-instellingen kunt u geavanceerde instellingen opgeven voor het descriptor-bestand van de toepassing. Wanneer u op de knop Instellingen klikt, wordt het dialoogvenster Geavanceerde instellingen weergegeven. Met het dialoogvenster Geavanceerde instellingen kunt u geassocieerde bestandtypes opgeven die de toepassing moet behandelen. Bijvoorbeeld, als u wilt dat uw toepassing de hoofdtoepassing wordt voor het behandelen van HTMLbestanden, moet u dit opgeven in het tekstvak Geassocieerde bestandstypes. U kunt ook instellingen opgeven voor de volgende aspecten van de toepassing:

• De grootte en plaatsing van het initiële venster • De map waarin de toepassing is geïnstalleerd • De map met het Programmamenu waarin de toepassing moet worden geplaatst Het dialoogvenster heeft de volgende opties: Geassocieerde bestandstypes Hiermee kunt u de geassocieerde bestandstypes opgeven die de AIR-toepassing

behandelt. Klik op de knop Plus (+) om een nieuw bestandstype toe te voegen aan het tekstvak. Wanneer u op de Plusknop drukt wordt het dialoogvenster Instellingen van bestandstype weergegeven. Wanneer u klikt op de knop Min () wordt een item dat is geselecteerd in het tekstvak verwijderd. Wanneer u klikt op de knop Potlood wordt het dialoogvenster Instellingen van bestandstype weergegeven en kunt u een item dat u hebt geselecteerd in het tekstvak bewerken. De knoppen Min (-) en Potlood zijn standaard uitgeschakeld. Door een item te selecteren in het tekstvak kunt u de knoppen Min (-) en Potlood inschakelen waardoor u het item kunt verwijderen of bewerken. De standaardwaarde in het tekstvak is Geen. Raadpleeg “Instellingen bestandstypen” op pagina 19 voor meer informatie over de instellingen van de bestandstypen voor geassocieerde bestanden. Initiële vensterinstellingen Hiermee kunt u de instellingen voor grootte en plaatsing van het initiële

toepassingsvenster opgeven.

• Breedte: Geeft de initiële breedte aan van het venster in pixels. De waarde is standaard leeg. • Hoogte: Geeft de initiële hoogte aan van het venster in pixels. De waarde is standaard leeg. • X: Geeft de initiële horizontale positie aan van het venster in pixels. De waarde is standaard leeg. • Y: Geeft de initiële verticale positie aan van het venster in pixels. De waarde is standaard leeg. • Maximumbreedte en maximunhoogte: Geven de maximumgrootte aan van het venster in pixels. Deze waarden zijn standaard leeg.

• Minimumbreedte en minimumhoogte: Geven de minimumgrootte aan van het venster in pixels. Deze waarden zijn standaard leeg.

• Vergrootbaar: Hiermee kunt u aangeven of de gebruiker het venster kan vergroten. Deze optie is standaard (of echt) geselecteerd.

• Verkleinbaar: Hiermee kunt u aangeven of de gebruiker het venster kan verkleinen. Deze optie is standaard (of echt) geselecteerd.

• Afmetingen wijzigen: Hiermee kunt u aangeven of de gebruiker de afmetingen van het venster kan wijzigen. Als deze optie niet is geselecteerd, zijn Maximumbreedte, Maximumhoogte, Minimumbreedte, en Minimumhoogte uitgeschakeld. Deze optie is standaard (of echt) geselecteerd.

• Zichtbaar: Hiermee geeft u aan of het toepassingsvenster initieel zichtbaar is. De optie is standaard (of echt) geselecteerd.


Andere instellingen Hiermee geeft u de volgende bijkomende gegevens aan in verband met de installatie:

• Installatiemap: Geeft de map aan waarin de toepassing is geïnstalleerd. • Map met programmamenu: Geeft de naam aan van de map met het programmamenu voor de toepassing. • Aangepaste update UI: Geeft aan wat er gebeurt wanneer een gebruiker een AIR-bestand opent voor een toepassing die reeds is geïnstalleerd. Standaard geeft AIR een dialoogvenster weer waarmee de gebruiker de geïnstalleerde versie kan bijwerken met de versie in het AIR-bestand. Als u niet wilt dat de gebruiker een dergelijke beslissing neemt en dat de toepassing het volledige beheer heeft over zijn updates, dan selecteert u deze optie. Wanneer u deze optie selecteert wordt het standaardgedrag overschreven en krijgt de toepassing het beheer over zijn eigen updates. Raadpleeg “AIR-toepassingen updaten” op pagina 336 voor meer informatie over het programmatisch updaten van een AIR-toepassing.

Instellingen bestandstypen Flash geeft het dialoogvenster Instellingen van bestandstype weer als u klikt op de knop Plus (+) of de knop Potlood in het dialoogvenster met geavanceerde instellingen zodat geassocieerde bestandstypes van de toepassing kunnen worden toegevoegd of bewerkt. De enige twee verplichte velden in dit dialoogvenster zijn Naam en Extensie. Als u klikt op OK en een van beide velden is leeg, geeft Flash een dialoogvenster met een foutmelding weer. U kunt volgende instellingen opgeven voor een geassocieerd bestandstype: Naam De naam van het bestandstype (bijvoorbeeld, Hypertext Markup Language, Tekstbestand, of Voorbeeld). Extensie De extensie van de bestandsnaam (bijvoorbeeld, html, txt, of xmpl), tot 39 alfanumerieke basistekens, (A-Zaz0-9), en zonder een voorafgaande periode. Beschrijving Optioneel. Een beschrijving van het bestandstype (bijvoorbeeld, Adobe videobestand). inhoudstype Optioneel. Specificeert het MIME-type voor het bestand. Instellingen van het bestandstype-pictogram Optioneel. Hiermee kunt u een pictogram opgeven dat is gekoppeld aan

het bestandstype. U kunt vier verschillende groottes opgeven voor het pictogram (128x128, 48x48, 32x32, en 16x16 pixels) om de verschillende weergaven waarin het pictogram verschijnt mogelijk te maken. Bijvoorbeeld, het pictogram kan worden weergegeven in de bestandsbrowser als thumbnail, gedetailleerd en naast elkaar. Als u een afbeelding opgeeft, moet het de grootte hebben die u specificeert. Als u geen bestand opgeeft voor een bepaalde grootte gebruikt AIR de afbeelding van vergelijkbare grootte en past het de afmetingen aan wat is opgegeven aan. Om een pictogram op te geven, klikt u ofwel op de map voor de pictogramgrootte en selecteert u een pictogrambestand dat u wilt gebruiken, of u voert het pad en de bestandsnaam in voor het pictogrambestand in het tekstvak naast de prompt. Het pictogrambestand moet in PNG-formaat zijn. Nadat een nieuw bestandstype is aangemaakt, wordt dit weergegeven in het lijstvak Bestandstype in het dialoogvenster van de geavanceerde instellingen.

Instellingen van descriptor-bestand van toepassing De toepassinginstellingen die u opgeeft worden opgeslagen in het bestand toepassing_naam-app.xml. U hebt echter de keuze om in Flash aan te geven dat u een aangepast descriptor-bestand van de toepassing wilt gebruiken. Een aangepast descriptor-bestand van de toepassing gebruiken Hiermee kunt u bladeren naar een aangepast descriptor-bestand van de toepassing. Als u Aangepast descriptor-bestand van de toepassing gebruiken selecteert, wordt in het dialoogvenster de sectie met toepassingsinstellingen uitgeschakeld. Om de locatie op te geven van het aangepast descriptor-bestand van de toepassing, voert u het ofwel in in onderstaand tekstveld Aangepast descriptorbestand van de toepassing gebruiken, of klikt u op het mappictogram en gaat u naar de locatie. Raadpleeg “Een


aangepast descriptor-bestand van de toepassing aanmaken” op pagina 21 voor meer informatie over het descriptorbestand van de toepassing.

Installer-instellingen Het tweede deel van het dialoogvenster AIR - Toepassings- en Installer-instellingen bevat instellingen die betrekking hebben op de installatie van de toepassing. Digitale handtekening Alle Adobe AIR-toepassingen moeten worden ondertekend om te kunnen worden geïnstalleerd in een ander systeem. Raadpleeg “Uw toepassing ondertekenen” op pagina 21 voor meer informatie over het toewijzen van een digitale handtekening aan een Flash Adobe AIR-toepassing. Bestemming Geeft aan waar het AIR-bestand moet worden opgeslagen. De standaardlocatie is de directory waarin u

het FLA-bestand hebt opgeslagen. Klik op het pictogram van de map om een andere locatie te selecteren. De standaardpakketnaam is de naam van de toepassing met de bestandsnaamextensie .air. Bijgevoegde bestanden/mappen Geeft aan welke bijkomende bestanden en mappen bij uw toepassing moeten

worden gevoegd. Klik op de knop Plus (+) om bestanden toe te voegen en op de knop van de map om mappen toe te voegen. Om een bestand of map te verwijderen uit uw lijst selecteert u het bestand of de map en klikt u op de knop Min (-). Standaard worden het descriptor-bestand van de toepassing en het hoofd SWF-bestand automatisch toegevoegd aan de pakketlijst. De pakketlijst toont deze bestanden zelfs wanneer u het Adobe AIR FLA-bestand nog niet hebt gepubliceerd. De pakketlijst geeft de bestanden en mappen weer in een vlakke structuur. Bestanden in een map worden niet weergegeven, en volledige padnamen naar bestanden worden weergegeven maar kunnen indien nodig worden ingekort. Pictogrambestanden zijn niet opgenomen in de lijst. Wanneer Flash de bestanden comprimeert, worden de pictogrambestanden naar een tijdelijke map gekopieerd die gekoppeld is aan de locatie van het SWF-bestand. Flash wist de map nadat het comprimeren is voltooid.

Aanmaak van toepassings- en installer-bestanden mislukt De toepassings- en installer-bestanden worden in volgende gevallen niet aangemaakt:

• De toepassings-id-string heeft een onjuiste lengte of bevat ongeldige tekens. De toepassings-id-string mag 1 tot 212 tekens hebben en mag volgende tekens omvatten: 0-9, a-z, A-Z, . (punt), - (koppelteken).

• Bestanden in de installer-lijst bestaan niet. • De groottes van de aangepaste pictogrambestanden zijn niet correct. • De AIR-bestemmingsmap heeft geen schrijfrechten. • U hebt de toepassing niet getekend of u hebt niet opgegeven dat het een Adobe AIRI-toepassing betreft die later zal worden ondertekend.


Een aangepast descriptor-bestand van de toepassing aanmaken Het descriptor-bestand van de toepassing is een XML-bestand dat u kunt bewerken met een tekstbewerker. Om een aangepast descriptor-bestand van de toepassing aan te maken, bewerkt u de waarden om aan te geven welke waarden u wenst. De standaardwaarden worden hier weergegeven:

• id = com.adobe.voorbeeld.swfname • fileName = swfname • name = swfname • versie = 1.0 • beschrijving = leeg • copyright = leeg • initialWindow • titel= naam • inhoud = swfname.swf • systemChrome = standaard, type = normaal • transparant = fout • zichtbaar = juist • pictogram • image128x128 = icons/AIRApp_128.png • image48x48 = icons/AIRApp_48.png • image32x32 = icons/AIRApp_32.png • image16x16 = icons/AIRApp_16.png • customUpdateUI = fout • allowBrowserInvocation = fout Raadpleeg “Eigenschappen van AIR-toepassingen instellen” op pagina 45 voor meer informatie over het descriptor-bestand van de toepassing.

Uw toepassing ondertekenen Alle Adobe AIR-toepassingen moeten worden ondertekend om te kunnen worden geïnstalleerd in een ander systeem. Flash biedt echter de mogelijkheid om niet ondertekende Adobe AIR-installer-bestanden aan te maken zodat de toepassing later kan worden ondertekend. Deze niet ondertekende Adobe AIR-installer-bestanden worden een AIRIpakket genoemd. Deze mogelijkheid wordt gebruikt in gevallen waarbij het certificaat zich op een ander toestel bevindt, of wanneer ondertekenen niet samen met de toepassingsontwikkeling wordt behandeld.


Onderteken een Adobe AIR-toepassing met een vooraf aangekocht digitaal certificaat van een basis certificaatautoriteit 1 Klik op de knop Digitale handtekening instellen in het dialoogvenster AIR - Toepassings en Installer-instellingen. Het dialoogvenster Digitale handtekening wordt geopend. Dit dialoogvenster heeft twee radioknoppen waarmee u uw Adobe AIR-toepassing kunt ondertekenen met een digitaal certificaat of waarmee u een AIRI-pakket kunt voorbereiden. Als u uw AIR-toepassing ondertekent, kunt u ofwel een digitaal certificaat gebruiken dat werd toegewezen door een basiscertificaatautoriteit, of u kunt een zelfondertekend certificaat aanmaken. Een zelfondertekend certificaat is eenvoudig te maken, maar is niet zo veilig als een certificaat dat werd toegekend door een basiscertificaatautoriteit.

Dialoogvenster voor digitale handtekening voor het ondertekenen van een AIR-toepassing

2 Selecteer een certificaatbestand in het pop-upmenu of klik op de knop Bladeren om een certificaatbestand te

zoeken. 3 Selecteer het certificaat. 4 Voer een wachtwoord in. 5 Klik op OK.

Raadpleeg “AIR-bestanden digitaal ondertekenen” op pagina 328 voor meer informatie over het ondertekenen van uw AIR-toepassing. Een zelfondertekend digitaal certificaat maken 1 Klik op de knop Aanmaken. Het dialoogvenster Zelfondertekend digitaal certificaat maken, wordt geopend. 2 Vul volgende velden in: Naam uitgever, Afdeling organisatie, Naam organisatie, Land, Wachtwoord, en

Wachtwoord bevestigen. 3 Geef het soort certificaat op.

Het soort certificaat houdt verband met het niveau van beveiliging van het certificaat: 1024-RSA gebruikt een 1024bit-code (minder veilig), en 2048-RSA gebruikt een 2048-bit-code (veiliger). 4 Sla de gegevens op in een certificaatbestand via Opslaan als, of door te klikken op de knop Bladeren om naar een

maplocatie te gaan. 5 Klik op OK. 6 In het dialoogvenster Digitale handtekening voert u het wachtwoord in dat u hebt toegekend in de tweede stap van

deze procedure en klikt u op OK.


Nadat u het digitale certificaat hebt ingesteld, wordt de knop Instellen veranderd in de knop Wijzigen. Om ervoor te zorgen dat Flash het wachtwoord dat u voor deze sessie heeft gebruikt onthoudt, klikt u op Wachtwoord onthouden voor deze sessie. Als de optie Tijdstempel niet geselecteerd is wanneer u op OK klikt, waarschuwt een dialoogvenster u dat de toepassing niet zal worden geïinstalleerd wanneer het digitale certificaat is verlopen. Als u op Ja klikt als antwoord op de waarschuwing, dan wordt de tijdstempel uitgeschakeld. Als u op Nee klikt, wordt de optie Tijdstempel automatisch geselecteerd en ingeschakeld. Raadpleeg “AIR-bestanden digitaal ondertekenen” op pagina 328 voor meer informatie over het maken van een zelfondertekend certificaat. U kunt ook een AIR Intermediate-toepassing (AIRI) aanmaken zonder een digitale handtekening. Een gebruiker kan de toepassing echter niet op een bureaublad installeren zolang u geen digitale handtekening hebt toegevoegd. Een AIRI-pakket voorbereiden dat later zal worden ondertekend ❖ In het dialoogvenster Digitale handtekening selecteert u Een AIRI-pakket voorbereiden dat later zal worden ondertekend, en vervolgens klikt u op OK. De status van de digitale handtekening wordt gewijzigd om aan te geven dat u ervoor hebt gekozen een AIRI-pakket voor te bereiden dat later zal worden ondertekend; en de knop Instellen verandert in de knop Wijzigen.

24

Hoofdstuk 7: Beveiliging in AIR In dit onderwerp worden beveiligingsproblemen besproken die u in acht moet nemen bij het ontwikkelen van een AIR-toepassing.

Basisbeginselen van beveiliging in AIR AIR-toepassingen worden met dezelfde gebruikersrechten als native toepassingen uitgevoerd. Over het algemeen bieden deze toegangsrechten brede toegang tot functies van het besturingssysteem, zoals het lezen en schrijven van bestanden, het starten van toepassingen, het tekenen op het scherm en het communiceren met het netwerk. Beperkingen van het besturingssysteem die gelden voor native toepassingen, zoals gebruikersspecifieke rechten, gelden ook voor AIR-toepassingen. Het beveiligingsmodel van Adobe® AIR™ is weliswaar een evolutie van het beveiligingsmodel van Adobe® Flash® Player maar het beveiligingscontract verschilt van het contract dat op inhoud in een browser wordt toegepast. Dit contract biedt ontwikkelaars een veilige manier om te beschikken over een bredere functionaliteit voor interessante ervaringen, met een vrijheid die niet geschikt is voor browsertoepassingen. AIR-toepassingen worden geschreven in gecompileerde bytecode (SWF-inhoud) of met geïnterpreteerde scripts (JavaScript, HTML), zodat de runtime geheugenbeheer biedt. Dit beperkt de kwetsbaarheid van AIR-toepassingen voor geheugenbeheerproblemen zoals buffer overflow en gegevensbeschadiging. Hieronder ziet u een aantal van de meest voorkomende problemen bij desktoptoepassingen die in native code zijn geschreven.

Installatie en updates AIR-toepassingen worden gedistribueerd via AIR-installatiebestanden met de extensie air. Wanneer Adobe AIR wordt geïnstalleerd en een AIR-installatiebestand wordt geopend, beheert de runtime de installatiemethode. Opmerking: Ontwikkelaars kunnen een versie, toepassingsnaam en uitgeversbron opgeven maar de initiële workflow zelf van de toepassingsinstallatie kan niet worden gewijzigd. Deze beperking is nuttig voor de gebruiker omdat hierdoor alle AIR-toepassingen dezelfde veilige, gestroomlijnde en consistente installatiemethode hebben, die door de runtime wordt beheerd. Als een toepassing moet worden aangepast, kan dit plaatsvinden wanneer de toepassing de eerste keer wordt gestart.

Installatielocatie van runtime Voor AIR-toepassingen moet eerst de runtime op de computer van de gebruiker worden geïnstalleerd, zoals voor SWF-bestanden eerst de Flash Player plug-in voor de browser moet worden geïnstalleerd. De runtime wordt op de volgende locatie op de computer van de gebruiker geïnstalleerd:

• Mac OS: /Library/Frameworks/ • Windows: C:\Program • Linux: /opt/Adobe

Files\Common Files\Adobe AIR

AIR/

ONTWIKKELING VAN ADOBE AIR 1.5-TOEPASSINGEN MET FLASH CS4 PROFESSIONAL 25 Beveiliging in AIR

Als een gebruiker in Mac OS een recentere versie van een toepassing wil installeren, moet de gebruiker over voldoende toegangsrechten beschikken om te installeren in de toepassingsmap. In Windows en Linux moet de gebruiker over beheerdersrechten beschikken. De runtime kan op twee manieren worden geïnstalleerd: met behulp van de naadloze installatiefunctie (installatie rechtstreeks vanuit een webbrowser) of via een handmatige installatie. Zie “AIR-toepassingen distribueren, installeren en uitvoeren” op pagina 319voor meer informatie.

Naadloze installatie (runtime en toepassing) De naadloze installatiefunctie biedt ontwikkelaars een gestroomlijnde installatiemethode voor gebruikers die Adobe AIR nog niet hebben geïnstalleerd. Bij de naadloze installatiemethode maakt de ontwikkelaar een SWF-bestand dat de te installeren toepassing opgeeft. Wanneer de gebruiker op het SWF-bestand klikt om de toepassing te installeren, probeert het SWF-bestand de runtime te detecteren. Als de runtime niet kan worden gedetecteerd, wordt deze geïnstalleerd en onmiddellijk gestart met de installatiemethode voor de toepassing van de ontwikkelaar.

Handmatige installatie De gebruiker kan echter ook de runtime handmatig downloaden en installeren vooraleer een AIR-bestand te openen. In dat geval beschikt de ontwikkelaar over verschillende manieren om een AIR-bestand te distribueren (bijvoorbeeld via e-mail of een HTML-koppeling op een website). Nadat het AIR-bestand is geopend, begint de runtime de toepassing te installeren. Zie “AIR-toepassingen distribueren, installeren en uitvoeren” op pagina 319voor meer informatie over deze methode.

Installatieflow van toepassing Het beveiligingsmodel van AIR biedt de gebruiker de keuze om een AIR-toepassing al dan niet te installeren. De installatiemethode van AIR biedt meerdere voordelen ten opzichte van native installatietechnologieën voor toepassingen, wat het maken van dit vertrouwensbesluit vergemakkelijkt voor de gebruiker:

• De runtime biedt een consistente installatiemethode in alle besturingssystemen, zelfs als een AIR-toepassing via een koppeling in een webbrowser wordt geïnstalleerd. De meeste native installatiemethoden voor toepassingen zijn afhankelijk van de browser of een andere toepassing voor het leveren van beveiligingsinformatie en in sommige gevallen wordt zelfs helemaal geen beveiligingsinformatie geleverd.

• De AIR-installatiemethode voor toepassingen identificeert de bron van de toepassing en informatie over de toegangsrechten van de toepassing (mits de gebruiker de installatie laat plaatsvinden).

• De runtime beheert de installatiemethode van een AIR-toepassing. Een AIR-toepassing heeft geen controle over de installatiemethode die door de runtime wordt gebruikt. De gebruiker wordt doorgaans niet aangeraden desktoptoepassingen te installeren die afkomstig zijn van een nietvertrouwde bron of een bron die niet kan worden gecontroleerd. De bewijslast op het gebied van veiligheid bij native toepassingen geldt ook voor AIR-toepassing en andere installeerbare toepassingen.

Doellocatie van toepassing De installatiedirectory kan worden ingesteld met een van de volgende twee opties: 1 De gebruiker kiest de doellocatie tijdens de installatie. De toepassing wordt geïnstalleerd op de locatie die door de

gebruiker is opgegeven.


2 Als de gebruiker de standaard installatielocatie niet wijzigt, wordt de toepassing geïnstalleerd volgens het

standaardpad dat door de runtime wordt bepaald:

• Mac OS: ~/Applications/ • Windows XP en oudere versies: C:\Program

Files\

• Windows Vista: ~/Apps/ • Linux: /opt/ Als de ontwikkelaar in het descriptorbestand van de toepassing een waarde opgeeft voor installFolder, wordt de toepassing geïnstalleerd in een subpad van deze directory.

Bestandssysteem van AIR Tijdens de installatie van een AIR-toepassing worden alle bestanden die de ontwikkelaar in het installatiebestand van de AIR-toepassing heeft opgenomen, gekopieerd naar de lokale computer van de gebruiker. De geïnstalleerde toepassing bestaat uit:

• Windows: een directory met alle bestanden die in het installatiebestand van de AIR-toepassing zijn opgenomen. Tijdens de installatie van de AIR-toepassing maakt de runtime ook een EXE-bestand.

• Linux: Een map met alle bestanden die in het AIR-installatiebestand zijn opgenomen. De runtime maakt ook een BIN-bestand tijdens de installatie van de AIR-toepassing.

• Mac OS: een APP-bestand met de volledige inhoud van het installatiebestand van de AIR-toepassing. Dit kan worden geïnspecteerd met de opdracht Toon pakketinhoud in Finder. Tijdens de installatie van de AIR-toepassing maakt de runtime dit APP-bestand. AIR-toepassingen worden als volgt gestart:

• Windows: voer het bestand met de extensie .exe in de installatiemap of een snelkoppeling naar dit bestand uit (bijvoorbeeld in het menu Start of op het bureaublad).

• Linux: Het BIN-bestand starten in de installatiemap, de toepassing kiezen in het menu Toepassingen of uitvoeren vanuit een alias of koppeling op het bureaublad.

• Mac OS: voer het bestand met de extensie .app of een alias van dit bestand uit. Het bestandssysteem van de toepassing bevat ook subdirectory's betreffende de functie van de toepassing. Bijvoorbeeld: informatie die naar een gecodeerde lokale opslaglocatie wordt geschreven, wordt opgeslagen in een subdirectory in een directory met de naam van de toepassingsidentificatie.

Opslag van AIR-toepassing AIR-toepassingen hebben de vereiste rechten om te schrijven naar een willekeurige locatie op de vaste schijf van de gebruiker. Ontwikkelaars wordt echter aangeraden om het pad app-storage:/ voor lokale opslag van hun toepassing te gebruiken. Bestanden die vanuit een toepassing naar app-storage:/ worden geschreven, bevinden zich op een standaardlocatie die afhankelijk is van het besturingssysteem van de gebruiker:

• In Mac OS: de opslagdirectory van een toepassing is //Local

Store/, waarbij de

voorkeursmap van de gebruiker is, meestal: /Users/<user>/Library/Preferences

• In Windows: de opslagdirectory van een toepassing is \\Local

Store\, waarbij de CSIDL_APPDATA 'speciale map' van de gebruiker is, meestal: C:\Documents and Settings\< gebruiker>\Application Data

• In Linux: //Local

Store/, waarbij /home/< gebruiker>/.appdata is


U hebt toegang tot de opslagdirectory voor toepassingen via de eigenschap air.File.applicationStorageDirectory. U kunt de inhoud ervan bekijken via de methode resolvePath() van de klasse File. Zie “Werken met het bestandssysteem” op pagina 109 voor meer informatie.

Adobe AIR updaten Wanneer de gebruiker een AIR-toepassing installeert waarvoor een recentere runtime is vereist, installeert de runtime automatisch de vereiste update. Voor het updaten van de runtime moet de gebruiker over beheerdersrechten voor de computer beschikken.

AIR-toepassingen updaten De ontwikkeling en distributie van software-updates is een van de grootste beveiligingsproblemen bij toepassingen in native code. De API van AIR biedt een mechanisme om dit risico te beperken: bij het starten kan de methode Updater.update() worden opgeroepen om een AIR-bestand te zoeken in een externe locatie. Als een update wordt gevonden, wordt het AIR-bestand gedownload en geïnstalleerd, en wordt de toepassing opnieuw gestart. Ontwikkelaars kunnen deze klasse niet alleen voor nieuwe functionaliteit gebruiken maar ook voor het bieden van oplossingen voor mogelijke beveiligingsproblemen. Opmerking: Ontwikkelaars kunnen de versie van een toepassing opgeven door de eigenschap version van het descriptorbestand van de toepassing in te stellen. AIR interpreteert de tekenreeks voor de versie helemaal niet. Met andere woorden, versie '3.0' wordt niet als recenter dan versie '2.0' beschouwd. De ontwikkelaar moet zorgen voor een correct versiebeheer. Zie “Eigenschappen definiëren in het descriptorbestand van de toepassing” op pagina 46voor meer informatie.

AIR-toepassingen verwijderen AIR-toepassingen worden als volgt verwijderd:

• In Windows: via het onderdeel Software van het Configuratiescherm. • In Mac OS: door het bestand met de extensie .app uit de installatiedirectory te verwijderen. Bij het verwijderen van een AIR-toepassing worden alle bestanden uit de toepassingsmap verwijderd. Eventuele bestanden die de toepassing buiten de toepassingsmap heeft gemaakt, worden echter niet verwijderd. Bij het verwijderen van een AIR-toepassing worden eventuele wijzigingen die de AIR-toepassing heeft aangebracht in bestanden buiten de toepassingsmap, niet ongedaan gemaakt.

Adobe AIR verwijderen AIR wordt als volgt verwijderd:

• In Windows: door het onderdeel Software van het Configuratiescherm te openen, Adobe AIR te selecteren en op de knop Verwijderen te klikken.

• In Mac OS: door de toepassing Adobe AIR Uninstaller in de directory Applications uit te voeren.

Windows-registerinstellingen voor beheerders In Windows kunnen beheerders een computer zo configureren dat de installatie van AIR-toepassingen en het uitvoeren van runtime-updates (niet) is toegestaan. Deze instellingen staan in het Windows-register onder de sleutel HKLM\Software\Policies\Adobe\AIR. De instellingen zijn onder andere:


Registerinstelling

Beschrijving

AppInstallDisabled

Geeft aan of het installeren en verwijderen van AIR-toepassingen is toegestaan. Zet op 0 voor 'toegestaan' of op 1 voor 'niet toegestaan'.

UntrustedAppInstallDisabled

Geeft aan of de installatie van niet-vertrouwde AIR-toepassingen (toepassingen die geen vertrouwd certificaat bevatten) is toegestaan (zie “AIR-bestanden digitaal ondertekenen” op pagina 328). Zet op 0 voor 'toegestaan' of op 1 voor 'niet toegestaan'.

UpdateDisabled

Geeft aan of het updaten van de runtime is toegestaan, als achtergrondtaak of als deel van een expliciete installatie. Zet op 0 voor 'toegestaan' of op 1 voor 'niet toegestaan'.

Sandboxen AIR biedt een uitgebreide beveiligingsarchitectuur die rechten definieert voor elk bestand van een AIR-toepassing, zowel intern als extern. De rechten worden aan bestanden toegekend op basis van hun oorsprong en zijn verdeeld in logische beveiligingsgroepen die sandboxen worden genoemd.

Informatie over AIR-toepassingssandboxen Het runtime-beveiligingsmodel van sandboxen bestaat uit het beveiligingsmodel van Flash Player, waaraan de toepassingssandbox is toegevoegd. Voor bestanden die zich niet in de toepassingssandbox bevinden, gelden beveiligingsbeperkingen vergelijkbaar met de beperkingen uit het beveiligingsmodel van Flash Player. De runtime gebruikt deze beveiligingssandboxen om het gegevensbereik te definiëren waartoe code toegang heeft en de bewerkingen die door code mogen worden uitgevoerd. De lokale veiligheid blijft gegarandeerd doordat de bestanden in elke sandbox gescheiden zijn van de bestanden van andere sandboxen. Bijvoorbeeld: een SWF-bestand dat vanaf een externe internet-URL is geladen in een AIR-toepassing, wordt in een externe sandbox geplaatst en heeft standaard niet de vereiste toegangsrechten om scriptcode te schrijven in bestanden in de toepassingsmap, die zijn toegewezen aan de toepassingssandbox. De volgende tabel beschrijft de verschillende sandboxtypen: Sandbox

Beschrijving

toepassing

Het bestand bevindt zich in de toepassingsmap en heeft alle AIR-toegangsrechten.

extern

Het bestand is afkomstig van een internet-URL en werkt met domeingebaseerde sandboxregels vergelijkbaar met de regels die gelden voor externe bestanden in Flash Player. (Er zijn aparte externe sandboxen voor elk netwerkdomein, zoals http://www.voorbeeld.com en https://foo.voorbeeld.org.)

lokaal-vertrouwd

Het bestand is een lokaal bestand en de gebruiker heeft het als vertrouwd gemarkeerd via Instellingsbeheer of met een Flash Player-vertrouwensconfiguratiebestand. Het bestand kan zowel van lokale gegevensbronnen lezen als met internet communiceren maar heeft niet alle AIRtoegangsrechten.

lokaal-met-netwerk

Het bestand is een lokaal SWF-bestand dat met een netwerktoewijzing is gepubliceerd maar niet expliciet door de gebruiker wordt vertrouwd. Het bestand kan met internet communiceren maar kan niet van lokale gegevensbronnen lezen. Deze sandbox is alleen beschikbaar voor SWF-inhoud.

lokaal-met-bestandssysteem

Het bestand is een lokaal scriptbestand dat niet met een netwerktoewijzing is gepubliceerd en niet expliciet door de gebruiker wordt vertrouwd. Dit geldt onder andere voor niet-vertrouwde JavaScriptbestanden. Het bestand kan van lokale gegevensbronnen lezen maar kan niet met internet communiceren.


Dit onderwerp is hoofdzakelijk gebaseerd op de toepassingssandbox en zijn relatie met andere sandboxen in de AIRtoepassing. Ontwikkelaars die inhoud gebruiken die is toegewezen aan andere sandboxen, wordt aangeraden aanvullende documentatie te lezen over het beveiligingsmodel van Flash Player. Raadpleeg het hoofdstuk "Flash Player-beveiliging" in de documentatie ActionScript 3.0 programmeren (http://www.adobe.com/go/flashcs4_prog_as3_security_nl) en het white paper Flash Player 9 Security (http://www.adobe.com/go/fp9_0_security) of het white paper Flash Player 10 Security (http://www.adobe.com/go/fp10_0_security_nl).

Toepassingssandbox Bij de installatie van een toepassing worden alle bestanden in het AIR-installatiebestand geïnstalleerd in een toepassingsmap op de computer van de gebruiker. Ontwikkelaars kunnen in de programmacode naar deze map verwijzen via het URL-schema app:/ (zie “URL-schema's van AIR gebruiken in URL's” op pagina 314). Alle bestanden in de toepassingsmapstructuur worden bij het starten van de toepassing aan de toepassingssandbox toegewezen. De inhoud van de toepassingssandbox heeft alle toegangsrechten die beschikbaar zijn voor een AIRtoepassing, zoals interactie met het lokale bestandssysteem. Vele AIR-toepassingen gebruiken alleen deze lokaal geïnstalleerde bestanden om de toepassing uit te voeren. AIRtoepassingen zijn echter niet beperkt tot de bestanden in de toepassingsmap; ze kunnen een willekeurig type bestand van een willekeurige bron laden. Dit geldt onder andere voor lokale bestanden op de computer van de gebruiker en bestanden op beschikbare externe bronnen, zoals op een lokaal netwerk of internet. Het type van de bestanden heeft geen invloed op de beveiligingsbeperkingen: geladen HTML-bestanden hebben dezelfde beveiligingsrechten als geladen SWF-bestanden van dezelfde bron. De inhoud van de toepassingsbeveiligingssandbox heeft toegang tot AIR API's die niet kunnen worden gebruikt door de inhoud van andere sandboxen. Voorbeeld: de eigenschap air.NativeApplication.nativeApplication.applicationDescriptor, die de inhoud van het descriptorbestand van de toepassing weergeeft, is beperkt tot de inhoud van de toepassingsbeveiligingssandbox. Een ander voorbeeld van een beperkte API is de klasse FileStream, die methoden voor het lezen van en schrijven naar het lokale bestandssysteem bevat. ActionScript API's die alleen beschikbaar zijn voor de inhoud van de toepassingsbeveiligingssandbox, zijn in de ActionScript 3.0 Language Reference for Adobe AIR gemarkeerd met het AIR-logo. Als deze API's in andere sandboxen worden gebruikt, genereert de runtime een SecurityError-fout. Bij HTML-inhoud (in een HTMLLoader-object) zijn alle AIR JavaScript API's (de API's die beschikbaar zijn via de eigenschap window.runtime, of via het object air bij het gebruik van het bestand AIRAliases.js) beschikbaar voor inhoud van de toepassingsbeveiligingssandbox. De HTML-inhoud van andere sandboxen heeft geen toegang tot de eigenschap window.runtime, zodat deze inhoud geen toegang heeft tot de AIR API's.

Beperkingen van JavaScript en HTML Voor de HTML-inhoud van de toepassingsbeveiligingssandbox zijn er beperkingen betreffende het gebruik van API's die tekenreeksen dynamisch in programmacode kunnen omzetten nadat de code is geladen. Hierdoor wordt voorkomen dat de toepassing onbedoeld code van niet-toepassingsbronnen (zoals mogelijk onveilige netwerkdomeinen) opneemt (en uitvoert). Een voorbeeld hiervan is het gebruik van de functie eval(). Zie “Codebeperkingen voor de inhoud van verschillende sandboxen” op pagina 33voor meer informatie.

Beperkingen betreffende img-tags in de inhoud van ActionScript-tekstvelden Om mogelijke phishingaanvallen te blokkeren worden img -tags in de HTML-inhoud van ActionScript TextFieldobjecten genegeerd in de SWF-inhoud van de toepassingsbeveiligingssandbox.


Beperkingen betreffende asfunction De inhoud van de toepassingssandbox kan geen gebruik maken van het protocol asfunction in de HTML-inhoud van ActionScript 2.0-tekstvelden.

Geen toegang tot niet-vluchtige cross-domain cache De SWF-inhoud van de toepassingssandbox kan geen gebruik maken van de cross-domain cache, een nieuwe functie vanaf Flash Player 9 Update 3. Met deze functie kan Flash Player de inhoud van componenten van het Adobe-platform opslaan in een niet-vluchtige cache en vervolgens op aanvraag opnieuw gebruiken in geladen SWF-inhoud (zodat de inhoud niet meerdere keren opnieuw hoeft te worden geladen).

Rechten van inhoud van niet-toepassingssandboxen Bestanden die vanaf een netwerk- of internetlocatie zijn geladen, worden toegewezen aan de externe remote sandbox. Bestanden die vanaf een locatie buiten de toepassingsmap zijn geladen, worden toegewezen aan de lokaalmet-bestandssysteem, lokaal-met-netwerk of lokaal-vertrouwde sandbox, afhankelijk van de manier waarop het bestand is aangemaakt en of de gebruiker het bestand als vertrouwd heeft gemarkeerd via de Global Settings Manager van Flash Player. Zie http://www.macromedia.com/support/documentation/en/flashplayer/help/settings_manager.html voor meer informatie.

Beperkingen van JavaScript en HTML In tegenstelling tot de inhoud van de toepassingsbeveiligingssandbox kan JavaScript-inhoud van een niettoepassingsbeveiligingssandbox wel de functie eval() oproepen om op elk gewenst moment dynamisch gegenereerde code uit te voeren. Er gelden echter beperkingen voor JavaScript in een niettoepassingsbeveiligingssandbox. Onder andere:

• JavaScript-code in een niet-toepassingssandbox heeft geen toegang tot het object window.runtime, zodat deze code geen AIR API's kan uitvoeren.

• De inhoud van een niet-toepassingsbeveiligingssandbox kan standaard geen XMLHttpRequest-oproepen gebruiken om gegevens te laden van andere domeinen dan het domein waarvan de aanvraag afkomstig is. Toepassingscode kan niet-toepassingsinhoud hiervoor echter toestemming geven door een kenmerk allowCrossdomainXHR in te stellen in het containerframe of iframe. Zie “Scripting tussen de inhoud van verschillende domeinen” op pagina 36voor meer informatie.

• Er zijn beperkingen betreffende het oproepen van de JavaScript-methode window.open(). Zie “Beperkingen betreffende het oproepen van de JavaScript-methode window.open()” op pagina 36voor meer informatie. Zie “Codebeperkingen voor de inhoud van verschillende sandboxen” op pagina 33voor meer informatie.

Beperkingen betreffende het laden van CSS-, frame-, iframe- en img-elementen De HTML-inhoud van externe (netwerk-) beveiligingssandboxen kan alleen inhoud van het type CSS, frame, iframe of img vanaf externe domeinen (netwerk-URL's) laden. De HTML-inhoud van lokaal-met-bestandssysteem, lokaal-met-netwerk of lokaal-vertrouwde sandboxen kan alleen inhoud van het type CSS, frame, iframe of img uit lokale sandboxen (niet van toepassings- of netwerk-URL's) laden.


Beveiliging in HTML De runtime past regels toe en biedt mechanismen voor het verhelpen van mogelijke beveiligingsproblemen in HTML en JavaScript. Hierbij worden altijd dezelfde regels toegepast, ongeacht of uw toepassing hoofdzakelijk in JavaScript is geschreven of dat u de HTML- en JavaScript-inhoud in een SWF-toepassing laadt. De inhoud van de toepassingssandbox en de inhoud van de niet-toepassingsbeveiligingssandbox (zie “Sandboxen” op pagina 28) hebben verschillende rechten. Wanneer inhoud in een iframe of frame wordt geladen, biedt de runtime een veilig sandboxbridge-mechanisme, waardoor de inhoud van het frame of iframe veilig kan communiceren met de inhoud van de toepassingsbeveiligingssandbox. In dit onderwerp wordt de AIR HTML-beveiligingsarchitectuur besproken, evenals het gebruik van iframes, frames en de sandboxbridge voor het configureren van uw toepassing. Zie “JavaScript-beveiligingsfouten voorkomen” op pagina 240voor meer informatie.

Overzicht van het configureren van uw HTML-toepassing Frames en iframes bieden een handige structuur voor het indelen van HTML-inhoud in AIR. Met frames kunt u zowel gegevens persistent houden als veilig werken met externe inhoud. Aangezien HTML in AIR zijn normale, op pagina's gebaseerde indeling behoudt, wordt de HTML-omgeving volledig vernieuwd als het bovenste frame van de HTML-inhoud naar een andere pagina 'navigeert'. U kunt frames en iframes gebruiken om gegevenspersistentie in AIR te behouden, ongeveer op dezelfde manier als voor een webtoepassing in een browser. Als u de belangrijkste toepassingsobjecten in het bovenste frame plaatst, persisteren ze tot u het frame naar een nieuwe pagina laat navigeren. Gebruik subframes of -iframes om de overgangsdelen van de toepassing te laden en weer te geven. (Er zijn verschillende manieren om voor gegevenspersistentie te zorgen als aanvulling op of in plaats van frames. Bijvoorbeeld cookies, lokale gedeelde objecten, lokale bestandsopslag, gecodeerde bestandsopslag en lokale databaseopslag.) Aangezien HTML in AIR ook de normale vage grens tussen uitvoerbare code en gegevens heeft, plaatst AIR inhoud in het bovenste frame van de HTML-omgeving in de toepassingssandbox. Na de gebeurtenis load waarbij de pagina wordt geladen, beperkt AIR alle bewerkingen zoals eval() waarbij een tekenreeks kan worden geconverteerd naar een uitvoerbaar object. Deze beperking wordt altijd toegepast, zelfs als een toepassing geen externe inhoud laadt. Als HTML-inhoud deze beperkte bewerkingen mag uitvoeren, moet u frames of iframes gebruiken om de inhoud in een niet-toepassingssandbox te plaatsen. (Soms moet inhoud in een onderliggend sandboxframe worden uitgevoerd wanneer wordt gewerkt met JavaScript-toepassingsraamwerken die zijn gebaseerd op de functie eval().) Zie “Codebeperkingen voor de inhoud van verschillende sandboxen” op pagina 33voor de volledige lijst van JavaScriptbeperkingen in de toepassingssandbox. Aangezien HTML in AIR de mogelijkheid behoudt om externe, mogelijk onveilige inhoud te laden, past AIR een 'beleid van zelfde oorsprong' toe om de voorkomen dat de inhoud van een bepaald domein in contact komt met de inhoud van een ander domein. Als u contact tussen de inhoud van de toepassing en de inhoud van een ander domein wilt toestaan, kunt u een bridge creëren die fungeert als interface tussen een hoofd- en een subframe.

Relatie tussen hoofd- en subsandbox creëren AIR voegt de kenmerken sandboxRoot en documentRoot toe aan de HTML frame- en iframe-elementen. Met deze kenmerken kunt u de toepassingsinhoud behandelen alsof deze van een ander domein afkomstig is:


Attribuut

Beschrijving

sandboxRoot

De URL waarmee de sandbox en het domein worden bepaald waarin de frameinhoud wordt geplaatst. Het URL-schema file:, http: of https: moet worden gebruikt.

documentRoot

De URL waarvan de frame-inhoud moet worden geladen. Het URL-schema file:, app: of app-storage: moet worden gebruikt.

In het volgende voorbeeld wordt de inhoud van de sandboxsubdirectory van de toepassing zo geconfigureerd dat deze wordt uitgevoerd in de externe sandbox en het domein www.example.com: <iframe src="ui.html" sandboxRoot="http://www.example.com/local/" documentRoot="app:/sandbox/">

Bridge tussen hoofd- en een subframes in verschillende sandboxen of domeinen instellen AIR voegt de eigenschappen childSandboxBridge en parentSandboxBridge toe aan het window-object van een willekeurig subframe. Met deze eigenschappen kunt u bridges definiëren als interfaces tussen een hoofd- en een subframe. Elke bridge gaat in één richting: childSandboxBridge - met de eigenschap childSandboxBridge kan het subframe een interface toegankelijk maken voor de inhoud van het hoofdframe. Als u een interface toegankelijk wilt maken, stelt u de eigenschap childSandbox in op een functie of object in het subframe. Vervolgens hebt u toegang tot het object of de functie vanuit de inhoud van het hoofdframe. In het volgende voorbeeld ziet u hoe een script dat in een subframe wordt uitgevoerd, een object dat een functie en een eigenschap bevat, toegankelijk kan maken voor het hoofdframe: var interface = {}; interface.calculatePrice = function(){ return .45 + 1.20; } interface.storeID = "abc" window.childSandboxBridge = interface;

Als deze onderliggende inhoud zich bevindt in een iframe waaraan de id"child" is toegewezen, hebt u vanuit de bovenliggende inhoud toegang tot de interface door de eigenschap childSandboxBridge van het frame te lezen: var childInterface = document.getElementById("child").childSandboxBridge; air.trace(childInterface.calculatePrice()); //traces "1.65" air.trace(childInterface.storeID)); //traces "abc" parentSandboxBridge - met de eigenschap parentSandboxBridge kan het bovenliggende frame een interface toegankelijk maken voor de inhoud van het subframe. Als u een interface toegankelijk wilt maken, stelt u de eigenschap parentSandbox van het onderliggende frame in op een functie of object in het bovenliggende frame. Vervolgens hebt u toegang tot het object of de functie vanuit de inhoud van het onderliggende frame. In het volgende voorbeeld ziet u hoe een script dat in het bovenliggende frame wordt uitgevoerd, een object dat de functie Save bevat, toegankelijk kan maken voor een onderliggend frame: var interface = {}; interface.save = function(text){ var saveFile = air.File("app-storage:/save.txt"); //write text to file } document.getElementById("child").parentSandboxBridge = interface;


Via deze interface kan de inhoud van het onderliggende frame bijvoorbeeld tekst opslaan in een bestand met de naam save.txt. De inhoud heeft echter geen andere toegang tot het bestandssysteem. Normaliter moet de toepassingsinhoud de kleinst mogelijke interface toegankelijk maken voor andere sandboxen. De onderliggende inhoud kan bijvoorbeeld de functie Save als volgt oproepen: var textToSave = "A string."; window.parentSandboxBridge.save(textToSave);

Als onderliggende inhoud een eigenschap van het object parentSandboxBridge probeert in te stellen, genereert de runtime een SecurityError-fout. Als bovenliggende inhoud een eigenschap van het object childSandboxBridge probeert in te stellen, genereert de runtime een SecurityError-fout.

Codebeperkingen voor de inhoud van verschillende sandboxen Zoals in de inleiding tot dit onderwerp, “Beveiliging in HTML” op pagina 31, is besproken, past de runtime regels toe en biedt deze mechanismen voor het verhelpen van mogelijke beveiligingsproblemen in HTML en JavaScript. De desbetreffende beperkingen staan in dit onderwerp. Als code deze beperkte API's probeert op te roepen, geeft de runtime de foutmelding weer dat er in de runtime van Adobe AIR een beveiligingsfout betreffende JavaScript-code in de toepassingsbeveiligingssandbox is opgetreden. Zie “JavaScript-beveiligingsfouten voorkomen” op pagina 240voor meer informatie.

Beperkingen betreffende het gebruik van de JavaScript-functie eval() en soortgelijke technieken Voor de HTML-inhoud van de toepassingsbeveiligingssandbox zijn er beperkingen betreffende het gebruik van API's die tekenreeksen dynamisch in programmacode kunnen omzetten nadat de code is geladen (nadat de gebeurtenis onload van het element body is verzonden en de handlerfunctie onload is voltooid). Hierdoor wordt voorkomen dat de toepassing onbedoeld code van niet-toepassingsbronnen (zoals mogelijk onveilige netwerkdomeinen) opneemt (en uitvoert). Als uw toepassing bijvoorbeeld tekenreeksgegevens van een externe bron gebruikt om naar de eigenschap innerHTML van een DOM-element te schrijven, bevat de tekenreeks mogelijk (JavaScript-) programmacode die onveilige bewerkingen kan uitvoeren. Tijdens het laden van de inhoud is er echter geen risico dat externe tekenreeksen in het DOM-element worden ingevoegd. Eén beperking betreft het gebruik van de JavaScript-functie eval(). Nadat code in de toepassingssandbox is geladen en de gebeurtenishandler onload is verwerkt, kunt u de functie eval() slechts met bepaalde beperkingen gebruiken. De volgende regels gelden voor het gebruik van de functie eval()nadat code is geladen uit de toepassingsbeveiligingssandbox:

• Expressies met literalen zijn toegestaan. Bijvoorbeeld: eval("null"); eval("3 + .14"); eval("'foo'");

• Objectliteralen zijn toegestaan, zoals in de volgende situatie: { prop1: val1, prop2: val2 }

• Setter/getters met objectliteralen zijn niet toegestaan, zoals in de volgende situatie: { get prop1() { ... }, set prop1(v) { ... } }

• Arrayliteralen zijn toegestaan, zoals in de volgende situatie: [ val1, val2, val3 ]


• Expressies met het lezen van eigenschappen zijn niet toegestaan, zoals in de volgende situatie: a.b.c

• Het oproepen van functies is niet toegestaan. • Functiedefinities zijn niet toegestaan. • Het instellen van eigenschappen is niet toegestaan. • Functieliteralen zijn niet toegestaan. Tijdens het laden van de code, vóór de gebeurtenis onload, en tijdens de uitvoering van de gebeurtenishandlerfunctie onload gelden deze beperkingen echter niet voor de inhoud van de toepassingsbeveiligingssandbox. Bij de volgende code bijvoorbeeld treedt een fout op nadat code is geladen: eval("alert(44)"); eval("myFunction(44)"); eval("NativeApplication.applicationID");

Dynamisch gegenereerde code, zoals bij het oproepen van de functie eval(), zou een veiligheidsrisico zijn als deze toegang kreeg tot de toepassingssandbox. Een toepassing kan bijvoorbeeld onbedoeld een tekenreeks uitvoeren die is geladen vanaf een netwerkdomein en schadelijke code bevat. De code kan bijvoorbeeld bestanden op de computer van de gebruiker verwijderen of wijzigen. Of de inhoud van een lokaal bestand doorsturen naar een niet-vertrouwd netwerkdomein. Dynamische code kan op de volgende manieren worden gegenereerd:

• door het oproepen van de functie eval(); • door eigenschappen van het type innerHTML of DOM-functies te gebruiken om scripttags in te voegen die een script buiten de toepassingsmap laden;

• door eigenschappen van het type innerHTML of DOM-functies te gebruiken om scripttags in te voegen die inline code bevatten (in plaats van een script te laden via het kenmerk src);

• door het kenmerk src voor script tags zo in te stellen dat een JavaScript-bestand wordt geladen dat zich buiten de toepassingsmap bevindt;

• door het URL-schema javascript te gebruiken (zoals in href="javascript:alert('Test')"); • door de functie setInterval() of setTimeout() te gebruiken, waarbij de eerste parameter (die de functie asynchroon laat uitvoeren) een (te evalueren) tekenreeks en geen functienaam is (zoals in setTimeout('x = 4', 1000));

• door document.write() of document.writeln() op te roepen. Code in de toepassingsbeveiligingssandbox kan tijdens het laden van inhoud alleen deze methoden gebruiken. Deze beperkingen blokkeren het gebruik van eval() met JSON-objectliteralen niet. Hierdoor kan de inhoud van uw toepassing met de JSON JavaScript-bibliotheek werken. U kunt echter geen overbelaste JSON-code (met gebeurtenishandlers) gebruiken. Voor andere Ajax-frameworks en JavaScript-codebibliotheken moet u controleren of de code in het framework of de bibliotheek binnen deze beperkingen betreffende dynamisch gegenereerde code werkt. Als dat niet het geval is, neemt u alle inhoud die gebruikmaakt van het framework of de bibliotheek op in een niet-toepassingsbeveiligingssandbox. Zie “Rechten van inhoud van niet-toepassingssandboxen” op pagina 30en “Scripting tussen toepassings- en niettoepassingsinhoud” op pagina 41voor meer informatie. Adobe houdt een lijst bij van Ajax-frameworks waarvan bekend is dat ze de toepassingsbeveiligingssandbox ondersteunen. Ga hiervoor naar http://www.adobe.com/products/air/develop/ajax/features/.


In tegenstelling tot de inhoud van de toepassingsbeveiligingssandbox kan JavaScript-inhoud van een niettoepassingsbeveiligingssandbox wel de functie eval() oproepen om op elk gewenst moment dynamisch gegenereerde code uit te voeren.

Beperkingen betreffende de toegang tot AIR API's (voor niet-toepassingssandboxen) JavaScript-code in een niet-toepassingssandbox heeft geen toegang tot het object window.runtime, zodat deze code geen AIR API's kan uitvoeren. Als de inhoud van een niet-toepassingsbeveiligingssandbox de volgende code oproept, treedt een TypeError-fout op: try { window.runtime.flash.system.NativeApplication.nativeApplication.exit(); } catch (e) { alert(e); }

Het fouttype is TypeError (niet-gedefinieerde waarde) omdat de inhoud van de niet-toepassingssandbox het object window.runtime niet herkent en het als een niet-gedefinieerde waarde beschouwt. Als u runtime-functionaliteit toegankelijk wilt maken voor de inhoud van een niet-toepassingssandbox, gebruikt u een scriptbridge. Zie “Scripting tussen toepassings- en niet-toepassingsinhoud” op pagina 41voor meer informatie.

Beperkingen betreffende het gebruik van XMLHttpRequest-oproepen De HTML-inhoud van een toepassingsbeveiligingssandbox kan geen synchrone XMLHttpRequest-methoden gebruiken om gegevens van buiten de toepassingssandbox te laden tijdens het laden van de HTML-inhoud en tijdens de gebeurtenis onLoad. De HTML-inhoud van niet-toepassingsbeveiligingssandboxen kan standaard geen JavaScript XMLHttpRequestobject gebruiken om gegevens te laden van andere domeinen dan het domein waarvan de aanvraag afkomstig is. Een tag van het type frame of iframe kan een kenmerk van het type allowcrosscomainxhr bevatten. Als u dit kenmerk instelt op een waarde die niet leeg is, kan de inhoud van het frame of iframe het Javascript XMLHttpRequest-object gebruiken om gegevens te laden van andere domeinen dan het domein van de code waarvan de aanvraag afkomstig is: <iframe id="UI" src="http://example.com/ui.html" sandboxRoot="http://example.com/" allowcrossDomainxhr="true" documentRoot="app:/">

Zie “Scripting tussen de inhoud van verschillende domeinen” op pagina 36voor meer informatie.

Beperkingen betreffende het laden van CSS-, frame-, iframe- en img-elementen (voor de inhoud van niet-toepassingssandboxen) De HTML-inhoud van externe (netwerk-) beveiligingssandboxen kan alleen inhoud van het type CSS, frame, iframe of img uit externe sandboxen (netwerk-URL's) laden. De HTML-inhoud van lokaal-met-bestandssysteem, lokaal-met-netwerk of lokaal-vertrouwde sandboxen kan alleen inhoud van het type CSS, frame, iframe of img uit lokale sandboxen (niet van toepassings- of externe sandboxen) laden.


Beperkingen betreffende het oproepen van de JavaScript-methode window.open() Als een venster dat door het oproepen van de JavaScript-methode window.open() is gemaakt, de inhoud van een niet-toepassingsbeveiligingssandbox weergeeft, begint de titel van het venster met de titel van het hoofdvenster (vanwaaruit het nieuwe venster is geopend), gevolgd door een dubbele punt. U kunt geen code gebruiken om dat deel van de venstertitel buiten het scherm te verplaatsen. De inhoud van niet-toepassingsbeveiligingssandboxen kan de JavaScript-methode window.open() alleen oproepen als reactie op een gebeurtenis die is gestart door een klik met de muisknop of een druk op een toets van het toetsenbord. Hierdoor wordt voorkomen dat niet-toepassingsinhoud vensters creëert die voor bedrog kunnen worden gebruikt (bijvoorbeeld voor phishingaanvallen). Ook kan de gebeurtenishandler voor de muis- of toetsenbordgebeurtenis de methode window.open() niet zo instellen dat deze na een vertraging wordt uitgevoerd (bijvoorbeeld door de functie setTimeout() op te roepen). De inhoud van externe (netwerk-) sandboxen kan de methode window.open() alleen gebruiken om de inhoud van externe netwerksandboxen te openen. Deze inhoud kan de methode window.open() niet gebruiken om de inhoud van de toepassingssandbox of van lokale sandboxen te openen. De inhoud van lokaal-met-bestandssysteem, lokaal-met-netwerk of lokaal-vertrouwde sandboxen (zie “Sandboxen” op pagina 28) kan de methode window.open() alleen gebruiken om de inhoud van lokale sandboxen te openen. Deze inhoud kan window.open() niet gebruiken om de inhoud van de toepassingssandbox of van externe sandboxen te openen.

Fouten bij het oproepen van beperkte code Als u code oproept die niet in een sandbox kan worden gebruikt vanwege deze beveiligingsbeperkingen, geeft de runtime de foutmelding weer dat er in de runtime van Adobe AIR een beveiligingsfout betreffende JavaScript-code in de toepassingsbeveiligingssandbox is opgetreden. Zie “JavaScript-beveiligingsfouten voorkomen” op pagina 240voor meer informatie.

Sandboxbescherming bij het laden van HTML-inhoud uit een tekenreeks Met de methode loadString() van de klasse HTMLLoader kunt u HTML-inhoud bij de uitvoering maken. De gegevens die u gebruikt als HTML-inhoud kunnen echter beschadigd zijn als de gegevens worden geladen uit een onbeveiligde internetbron. Om deze reden wordt HTML die is gemaakt met behulp van de methode loadString(), niet in de toepassingssandbox geplaatst en heeft deze HTML geen toegang tot API's van AIR. U kunt echter wel de eigenschap placeLoadStringContentInApplicationSandbox van een HTMLLoader-object instellen op true, zodat HTML die is gemaakt met de methode loadString(), in de toepassingssandbox wordt geplaatst. Zie “HTMLinhoud laden vanuit een tekenreeks” op pagina 238 voor meer informatie.

Scripting tussen de inhoud van verschillende domeinen Bij de installatie van AIR-toepassingen worden hieraan speciale rechten toegewezen. Het is van groot belang dat deze rechten niet aan andere inhoud worden doorgegeven, zoals externe bestanden en lokale bestanden die geen deel uitmaken van de toepassing.


Informatie over de AIR-sandboxbridge Inhoud van andere domeinen kan normaal gesproken geen scripts in andere domeinen oproepen. Om AIRtoepassingen te beschermen tegen onbedoelde lekkage van informatie of besturingselementen waarvoor speciale toegangsrechten gelden, gelden de volgende beperkingen voor de inhoud van de beveiligingssandbox application (inhoud die met de toepassing is geïnstalleerd):

• Code in de toepassingsbeveiligingssandbox mag geen toegang bieden tot andere sandboxen door de methode Security.allowDomain() op te roepen. Het oproepen van deze methode vanuit de toepassingsbeveiligingssandbox veroorzaakt een fout.

• Het importeren van niet-toepassingsinhoud in de toepassingssandbox door de eigenschap LoaderContext.securityDomain of LoaderContext.applicationDomain te activeren, wordt verhinderd.

Er zijn echter situaties waarin de AIR-hoofdtoepassing inhoud van een extern domein nodig heeft voor gecontroleerde toegang tot scripts in de AIR-hoofdtoepassing, of omgekeerd. Hiervoor biedt de runtime het mechanisme sandboxbridge, dat als gateway tussen beide sandboxen fungeert. Een sandboxbridge kan expliciete interactie tussen externe en toepassingsbeveiligingssandboxen bieden. De sandboxbridge maakt twee objecten toegankelijk, waartoe zowel geladen als ladende scripts toegang hebben:

• Het object parentSandboxBridge staat ladende inhoud toe om eigenschappen en functies toegankelijk te maken voor scripts in de geladen inhoud.

• Het object childSandboxBridge staat geladen inhoud toe om eigenschappen en functies toegankelijk te maken voor scripts in de ladende inhoud. Objecten die via de sandboxbridge toegankelijk worden gemaakt, worden doorgegeven op basis van waarde en niet op basis van referentie. Alle gegevens zijn geserialiseerd. Dit betekent dat de objecten die door de ene kant van de bridge toegankelijk zijn gemaakt, niet door de andere kant kunnen worden ingesteld, en dat alle toegankelijke objecten geen specifiek type hebben. Bovendien kunt u alleen eenvoudige objecten en functies toegankelijk maken, geen complexe objecten. Als onderliggende inhoud een eigenschap van het object parentSandboxBridge probeert in te stellen, genereert de runtime een SecurityError-fout. Evenzo genereert de runtime een SecurityError-fout als bovenliggende inhoud een eigenschap van het object childSandboxBridge probeert in te stellen.

Voorbeeld van sandboxbridge (SWF) Dit voorbeeld is gebaseerd op een AIR-toepassing voor een muziekwinkel. De toepassing wil externe SWF-bestanden toestaan om de prijs van albums toegankelijk te maken maar wil niet dat het externe SWF-bestand aangeeft of de prijs een opruimingsprijs is. Hiervoor biedt de klasse StoreAPI een methode die de prijs opvraagt maar de opruimingsprijs verbergt. Vervolgens wordt een instantie van deze StoreAPI-klasse toegewezen aan de eigenschap parentSandboxBridge van het LoaderInfo-object van het Loader-object dat het externe SWF-bestand laadt. Dit is de code voor de AIR-muziekwinkel:


<mx:WindowedApplication xmlns:mx="http://www.adobe.com/2006/mxml" layout="absolute" title="Music Store" creationComplete="initApp()"> <mx:Script> import flash.display.Loader; import flash.net.URLRequest; private var child:Loader; private var isSale:Boolean = false; private function initApp():void { var request:URLRequest = new URLRequest("http://[www.yourdomain.com]/PriceQuoter.swf") child = new Loader(); child.contentLoaderInfo.parentSandboxBridge = new StoreAPI(this); child.load(request); container.addChild(child); } public function getRegularAlbumPrice():String { return "$11.99"; } public function getSaleAlbumPrice():String { return "$9.99"; } public function getAlbumPrice():String { if(isSale) { return getSaleAlbumPrice(); } else { return getRegularAlbumPrice(); } } <mx:UIComponent id="container" />

Het StoreAPI-object roept de hoofdtoepassing op om de normale albumprijs op te vragen maar geeft “Not available” (Niet beschikbaar) weer wanneer de methode getSaleAlbumPrice() wordt opgeroepen. De volgende code definieert de klasse StoreAPI:


public class StoreAPI { private static var musicStore:Object; public function StoreAPI(musicStore:Object) { this.musicStore = musicStore; } public function getRegularAlbumPrice():String { return musicStore.getRegularAlbumPrice(); } public function getSaleAlbumPrice():String { return "Not available"; } public function getAlbumPrice():String { return musicStore.getRegularAlbumPrice(); } }

De volgende code is een voorbeeld van het SWF-bestand PriceQuoter (Prijsofferte), dat de verkoopprijs van de winkel weergeeft maar de opruimingsprijs niet kan weergeven: package { import flash.display.Sprite; import flash.system.Security; import flash.text.*; public class PriceQuoter extends Sprite { private var storeRequester:Object; public function PriceQuoter() { trace("Initializing child SWF"); trace("Child sandbox: " + Security.sandboxType); storeRequester = loaderInfo.parentSandboxBridge; var tf:TextField = new TextField(); tf.autoSize = TextFieldAutoSize.LEFT; addChild(tf); tf.appendText("Store price of album is: " + storeRequester.getAlbumPrice()); tf.appendText("\n"); tf.appendText("Sale price of album is: " + storeRequester.getSaleAlbumPrice()); } } }

Voorbeeld van sandboxbridge (HTML) Bij HTML-inhoud worden de eigenschappen parentSandboxBridge en childSandboxBridge toegevoegd aan het JavaScript window-object van een subdocument. Zie “Sandboxbridge-interface instellen” op pagina 254voor een voorbeeld van hoe u bridgefuncties definieert in HTML-inhoud.


API-toegankelijkheid beperken Bij het toegankelijk maken van sandboxbridges is het belangrijk dat u API's toegankelijk maakt die van een hoog niveau zijn en de mate beperken waarin ze kunnen worden misbruikt. Vergeet niet dat de inhoud die uw bridgeimplementatie oproept, door een kwaadwillige persoon kan zijn gewijzigd (bijvoorbeeld via een code-injectie). Dit betekent bijvoorbeeld dat een methode readFile(path:String) (die de inhoud van een willekeurig bestand leest) die via een bridge toegankelijk wordt gemaakt, kan worden misbruikt. Het is aan te raden een API readApplicationSetting() toegankelijk te maken die geen specifiek pad volgt en een specifiek bestand leest. De meer semantische methode beperkt de schade die een toepassing kan aanbrengen als een deel ervan door een kwaadwillige persoon is gewijzigd.

Zie ook “Cross-scripting van inhoud in verschillende beveiligingssandboxen” op pagina 253 “Toepassingssandbox” op pagina 29 “Rechten van inhoud van niet-toepassingssandboxen” op pagina 30

Naar schijf schrijven Toepassingen die in een webbrowser worden uitgevoerd, hebben slechts beperkte interactie met het lokale bestandssysteem van de gebruiker. Webbrowsers passen beveiligingsmaatregelen toe die zorgen dat de computer van de gebruiker niet in gevaar kan worden gebracht door het laden van webinhoud. Bijvoorbeeld: SWF-bestanden die via Flash Player in een browser worden uitgevoerd, kunnen niet rechtstreeks interageren met bestanden die al op de computer van de gebruiker staan. Gedeelde objecten en cookies kunnen naar de computer van de gebruiker worden geschreven voor het bijhouden van gebruikersvoorkeuren en andere gegevens, maar meer niet. Aangezien AIRtoepassingen in het besturingssysteem worden geïnstalleerd, gebruiken ze een ander beveiligingscontract, dat onder andere de mogelijkheid biedt om te lezen van en te schrijven naar het lokale bestandssysteem. Deze vrijheid gaat gepaard met een grote verantwoordelijkheid voor de ontwikkelaars. Toevallige kwetsbaarheden van toepassingen brengen niet alleen de functionaliteit van de toepassing in gevaar, maar ook de integriteit van de computer van de gebruiker. Daarom wordt ontwikkelaars aangeraden “Aanbevolen beveiligingsprocedures voor ontwikkelaars” op pagina 42te lezen. AIR-ontwikkelaars kunnen bestanden in het lokale bestandssysteem via verschillende URL-schemaconventies lezen/schrijven: URL-schema

Beschrijving

app:/

Een alias voor de toepassingsmap. Bestanden die via dit pad worden benaderd, worden toegewezen aan de toepassingssandbox en beschikken over alle toegangsrechten die door de runtime worden verleend.

app-storage:/

Een alias voor de lokale opslagdirectory, gestandaardiseerd door de runtime. Bestanden die via dit pad worden benaderd, worden toegewezen aan een niet-toepassingssandbox.

file:///

Een alias die de hoofddirectory van de vaste schijf van de gebruiker vertegenwoordigt. Aan een bestand dat via dit pad wordt benaderd, wordt een toepassingssandbox toegewezen als het bestand in de toepassingsmap bestaat. Als dat niet het geval is, wordt een niet-toepassingssandbox toegewezen.

Opmerking: AIR-toepassingen kunnen geen inhoud wijzigen via het URL-schema app:. Bovendien is de toepassingsmap mogelijk alleen-lezen, afhankelijk van de beheerdersinstellingen.


Als er geen beheerdersrechten voor de computer van de gebruiker vereist zijn, mogen AIR-toepassingen naar een willekeurige locatie op de vaste schijf van de gebruiker schrijven. Ontwikkelaars wordt aangeraden het pad appstorage:/ te gebruiken voor lokale opslag betreffende hun toepassing. Bestanden die vanuit een toepassing naar app-storage:/ worden geschreven, worden in een standaardlocatie geplaatst:

• In Mac OS: de opslagdirectory van een toepassing is //Local

Store/, waarbij de voorkeursmap van de gebruiker is. Dit is doorgaans /Users//Library/Preferences.

• In Windows: de opslagdirectory van een toepassing is \\Local

Store\, waarbij de CSIDL_APPDATA 'speciale map' van de gebruiker is. Dit is doorgaans C:\Documents and Settings\\Application Data.

• In Linux: //Local

Store/, waarbij /home/< gebruiker>/.appdata is

Als een toepassing is ontworpen om te interageren met bestaande bestanden in het bestandssysteem van de gebruiker, moet u “Aanbevolen beveiligingsprocedures voor ontwikkelaars” op pagina 42lezen.

Veilig werken met niet-vertrouwde inhoud Inhoud die niet aan de toepassingssandbox is toegewezen, kan uw toepassing aanvullende scriptfunctionaliteit bieden, maar alleen als wordt voldaan aan de beveiligingscriteria van de runtime. In dit onderwerp wordt het AIRbeveiligingscontract met niet-toepassingsinhoud besproken.

Security.allowDomain() AIR-toepassingen beperken de toegang van scripts voor niet-toepassingsinhoud in hogere mate dan de Flash Player plug-in voor de browser de toegang van scripts voor niet-vertrouwde inhoud. Bijvoorbeeld: wanneer in Flash Player in de browser een SWF-bestand dat is toegewezen aan de lokaal-vertrouwde sandbox de methode System.allowDomain() aanroept, wordt scripttoegang verleend voor een willekeurig SWF-bestand dat vanaf het opgegeven domein wordt geladen. Deze benadering is niet toegestaan voor toepassingsinhoud in AIR-toepassingen omdat hierdoor onredelijke toegang tot het niet-toepassingsbestand in het bestandssysteem van de gebruiker zou worden verleend. Externe bestanden hebben nooit rechtstreekse toegang tot de toepassingssandbox, ongeacht de aanwezigheid van oproepen van de methode Security.allowDomain().

Scripting tussen toepassings- en niet-toepassingsinhoud Voor AIR-toepassingen die scripts gebruiken tussen toepassings- en niet-toepassingsinhoud, gelden complexere beveiligingsmaatregelen. Bestanden die zich niet in de toepassingssandbox bevinden, hebben alleen via een sandboxbridge toegang tot de eigenschappen en methoden van bestanden in de toepassingssandbox. Een sandboxbridge is een gateway tussen toepassings- en niet-toepassingsinhoud, en maakt expliciete interactie tussen de twee bestanden mogelijk. Wanneer een sandboxbridges correct wordt gebruikt, biedt deze een extra beveiligingslaag door te zorgen dat niet-toepassingsinhoud geen toegang heeft tot objectverwijzingen die deel uitmaken van toepassingsinhoud. Het voordeel van sandboxbridges wordt het best met een voorbeeld geïllustreerd. Dit voorbeeld is gebaseerd op een AIR-toepassing voor een muziekwinkel. De winkel wil adverteerders die hun eigen SWF-bestanden willen maken, een API bieden waarmee de toepassing van de winkel vervolgens kan communiceren. De winkel wil adverteerders methoden bieden waarmee ze artiesten en cd's in de winkel kunnen opzoeken, maar wil om veiligheidsredenen ook bepaalde methoden en eigenschappen onbereikbaar maken voor de SWF-bestanden van de adverteerders.


Een sandboxbridge kan hiervoor zorgen. Inhoud die extern in een AIR-toepassing wordt geladen tijdens het gebruik van de runtime, heeft standaard geen toegang tot methoden of eigenschappen in de hoofdtoepassing. Met een aangepaste sandboxbridge-implementatie kan een ontwikkelaar services voor de externe inhoud bieden zonder deze methoden of eigenschappen toegankelijk te maken. De sandboxbridge is als een pad tussen vertrouwde en nietvertrouwde inhoud dat communicatie tussen de ladende en de geladen inhoud mogelijk maakt zonder objectverwijzingen toegankelijk te maken. Zie “Scripting tussen de inhoud van verschillende domeinen” op pagina 36voor meer informatie over hoe u sandboxbridges veilig gebruikt.

Bescherming tegen dynamisch gegenereerde, onveilige SWF-inhoud De methode Loader.loadBytes() biedt een toepassing de mogelijkheid om SWF-inhoud te genereren op basis van een bytearray. Injectieaanvallen op gegevens die van externe bronnen worden geladen, kunnen echter ernstige schade toebrengen bij het laden van inhoud. Dit geldt met name bij het laden van gegevens in de toepassingssandbox, waar de gegenereerde SWF-inhoud toegang heeft tot de volledige set van AIR API's. Er zijn echter ook situaties waarin het gebruik van de methode loadBytes() zonder het genereren van SWFprogrammacode vereist is. U kunt de methode loadBytes() gebruiken om grafische gegevens te genereren, bijvoorbeeld om de beeldweergavetiming te besturen. Er zijn ook situaties waarin wel programmacode mag worden gegenereerd, zoals bij het dynamisch genereren van SWF-inhoud voor het afspelen van audio. In AIR staat de methode loadBytes() u standaard niet toe om SWF-inhoud te laden; u mag alleen grafische inhoud laden. In AIR heeft de eigenschap loaderContext van de methode loadBytes() een eigenschap allowLoadBytesCodeExecution, die u op true kunt instellen om de toepassing expliciet toe te staan loadBytes() te gebruiken om SWF-programmacode te laden. In de volgende code wordt getoond hoe u deze functie gebruikt: var loader:Loader = new Loader(); var loaderContext:LoaderContext = new LoaderContext(); loaderContext.allowLoadBytesCodeExecution = true; loader.loadBytes(bytes, loaderContext);

Als u loadBytes() oproept om SWF-inhoud te laden en de eigenschap allowLoadBytesCodeExecution van het LoaderContext-object is ingesteld op false (dit is de standaardinstelling), genereert het Loader-object een SecurityError-fout. Opmerking: In een toekomstige versie van Adobe AIR wordt deze API mogelijk aangepast. In dat geval moet u mogelijk de inhoud die gebruikmaakt van de eigenschap allowLoadBytesCodeExecution van de klasse LoaderContext, opnieuw compileren.

Aanbevolen beveiligingsprocedures voor ontwikkelaars AIR-toepassingen zijn weliswaar gebaseerd op webtechnologieën maar ontwikkelaars mogen niet vergeten dat ze niet in de beveiligingssandbox van de browser werken. Dit betekent dat het mogelijk is om AIR-toepassingen te ontwikkelen die bedoeld of onbedoeld schade kunnen toebrengen aan het systeem. AIR probeert dit risico tot het minimum te beperken maar er zijn altijd wel manieren om kwetsbaarheden te genereren. In dit onderwerp worden belangrijke potentiële kwetsbaarheden besproken.


Risico bij het importeren van bestanden in de toepassingsbeveiligingssandbox Bestanden in de toepassingsmap zijn toegewezen aan de toepassingssandbox en beschikken over alle toegangsrechten van de runtime. Toepassingen die naar het lokale bestandssysteem schrijven, wordt aangeraden naar app-storage:/ te schrijven. Aangezien deze directory apart van de toepassingsbestanden op de computer van de gebruiker is geplaatst, zijn de bestanden niet toegewezen aan de toepassingssandbox en vormen ze een kleiner veiligheidsrisico. Ontwikkelaars wordt aangeraden het volgende in acht te nemen:

• Neem alleen indien nodig een bestand op in een AIR-bestand (in de geïnstalleerde toepassing). • Neem alleen een scriptbestand op in een AIR-bestand (in de geïnstalleerde toepassing) als het gedrag ervan volledig begrepen en vertrouwd wordt.

• Schrijf niet naar de toepassingsmap en wijzig de inhoud ervan niet. De runtime genereert een SecurityError-fout om te zorgen dat toepassingen geen bestanden en mappen via het URL-schema app:/ kunnen wijzigen of ernaar schrijven.

• Gebruik geen gegevens van een netwerkbron als parameters voor AIR API-methoden die tot de uitvoering van code kunnen leiden. Dit geldt onder andere voor het gebruik van de methode Loader.loadBytes() en de JavaScriptfunctie eval().

Risico bij het gebruiken van een externe bron voor het bepalen van paden Een AIR-toepassing kan in gevaar worden gebracht door het gebruik van externe gegevens of inhoud. Daarom moet extra worden opgelet bij het gebruik van gegevens van het netwerk of het bestandssysteem. De verantwoordelijkheid voor het geven van vertrouwen ligt uiteindelijk bij de ontwikkelaars en de netwerkverbindingen die ze maken, maar het laden van externe gegevens is altijd gevaarlijk en wordt het best niet gebruikt voor gegevensinvoer bij bewerkingen met vertrouwelijke gegevens. Ontwikkelaars wordt het volgende afgeraden:

• gegevens van een netwerkbron gebruiken om een bestandsnaam te bepalen; • gegevens van een netwerkbron gebruiken om een URL te definiëren die door de toepassing wordt gebruikt om persoonlijke informatie te verzenden.

Risico bij het gebruiken, opslaan of verzenden van onveilige gebruikersgegevens Het opslaan van gebruikersgegevens in het lokale bestandssysteem van de gebruiker brengt altijd het risico met zich mee dat deze gegevens door een kwaadwillige persoon zijn gewijzigd. Ontwikkelaars worden geadviseerd om rekening te houden met het volgende:

• Als gebruikersgegevens lokaal moeten worden opgeslagen, moeten ze worden gecodeerd bij het schrijven naar het lokale bestandssysteem. Via de klasse EncryptedLocalStore biedt de runtime unieke gecodeerde opslag voor elke geïnstalleerde toepassing. Zie “Gecodeerde gegevens opslaan” op pagina 220voor meer informatie.

• Verzend gebruikersgegevens niet ongecodeerd naar een netwerkbron, tenzij de desbetreffende bron wordt vertrouwd.

• Stel nooit een standaardwachtwoord in bij het creëren van gebruikersgegevens. Laat de gebruiker zijn of haar eigen wachtwoord instellen. Gebruikers die de standaardinstellingen niet wijzigen, stellen hun referenties bloot aan een hacker die het standaardwachtwoord kent.


Risico van een downgradeaanval Tijdens de installatie van een toepassing controleert de runtime of de toepassing momenteel niet is geïnstalleerd. Als de toepassing al is geïnstalleerd, vergelijkt de runtime het versienummer met dat van de geïnstalleerde versie. Als beide versies niet hetzelfde nummer hebben, kan de gebruiker desgewenst de bestaande installatie upgraden. De runtime garandeert echter niet dat de nieuwe versie recenter is dan de geïnstalleerde versie, alleen dat het een andere versie is. Een aanvaller kan de gebruiker een oudere versie sturen om gebruik te maken van deze kwetsbaarheid. Daarom wordt de ontwikkelaar aangeraden een versiecontrole uit te voeren bij het starten van de toepassing. Het is een goed idee om toepassingen het netwerk te laten doorzoeken op eventuele updates. Op die manier wordt onmiddellijk een verouderde versie gedetecteerd, zelfs als een aanvaller erin geslaagd is de gebruiker een oude versie te laten installeren. Ook het gebruik van een duidelijk versieschema voor uw toepassing maakt het moeilijk om gebruikers onbedoeld een oudere versie te laten installeren. Zie “Eigenschappen definiëren in het descriptorbestand van de toepassing” op pagina 46voor meer informatie over het bieden van verschillende versies van een toepassing.

Codeondertekening Alle AIR-installatiebestanden moeten zijn voorzien van codeondertekening. Codeondertekening is een cryptografisch proces waarbij wordt bevestigd dat de opgegeven oorsprong van software correct is. U kunt AIR-toepassingen ondertekenen door een certificaat van een externe certificeringsinstantie (CI) te koppelen of door uw eigen certificaat te genereren. Een commercieel certificaat van een bekende CI wordt ten zeerste aanbevolen en biedt uw gebruikers de garantie dat ze uw toepassing installeren, en geen vervalste versie. U kunt zelfondertekende certificaten genereren via adt uit de SDK of met behulp van Flash, Flex Builder of een andere toepassing die adt gebruikt voor het genereren van certificaten. Zelfondertekende certificaten bieden echter geen enkele garantie dat de toepassing die wordt geïnstalleerd, authentiek is. Zie “AIR-bestanden digitaal ondertekenen” op pagina 328en “AIR-toepassingen maken met behulp van opdrachtregelprogramma's” op pagina 363voor meer informatie over het digitaal ondertekenen van AIRtoepassingen.

45

Hoofdstuk 8: Eigenschappen van AIRtoepassingen instellen Naast alle bestanden en andere elementen die deel uitmaken van een AIR-toepassing, heeft elke AIR-toepassing een descriptorbestand nodig. Het descriptorbestand van de toepassing is een XML-bestand dat de basiseigenschappen van de toepassing definieert. Als u AIR-toepassingen ontwikkelt met Adobe® AIR™ Update voor Adobe® Flash® CS3 Professional of Adobe® Flash® CS4 Professional, wordt het descriptorbestand automatisch gegenereerd wanneer u een AIR-project maakt. In het menu Opdrachten > AIR - Instellingen voor toepassing en installer vindt u een deelvenster om de descriptorinstellingen te wijzigen. U kunt het descriptorbestand van de toepassing ook handmatig aanpassen.

De structuur van het descriptorbestand van de toepassing Het descriptorbestand van de toepassing bevat eigenschappen die gelden voor de volledige toepassing, zoals naam, versie, copyright enzovoort. U kunt een willekeurige naam voor het descriptorbestand van de toepassing gebruiken. Wanneer u in Flash CS3 of Flash CS4 met de standaardinstellingen een AIR-bestand maakt, wordt de naam van het toepassingsdescriptbestand gewijzigd in application.xml en wordt het bestand in een speciale map in het AIRpakket geplaatst. Voorbeeld van een descriptorbestand van de toepassing: com.example.HelloWorld 2.0 Hello World Example Co. AIR Hello World <description> This is a example. C'est un exemple. Esto es un ejemplo. Copyright (c) 2006 Example Co. Hello World HelloWorld-debug.swf <systemChrome>none true true <minimizable>true <maximizable>false false <width>640 480 <minSize>320 240

ONTWIKKELING VAN ADOBE AIR 1.5-TOEPASSINGEN MET FLASH CS4 PROFESSIONAL 46 Eigenschappen van AIR-toepassingen instellen

<maxSize>1280 960 Example Co/Hello World <programMenuFolder>Example Co icons/smallIcon.png icons/mediumIcon.png icons/bigIcon.png icons/biggestIcon.png <customUpdateUI>true false adobe.VideoFile <extension>avf <description>Adobe Video File application/vnd.adobe.video-file icons/avfIcon_16.png icons/avfIcon_32.png icons/avfIcon_48.png icons/avfIcon_128.png

Eigenschappen definiëren in het descriptorbestand van de toepassing Gebruik de XML-elementen en -kenmerken in de toepassingsdescriptor om de volgende typen eigenschappen voor uw AIR-toepassing te definiëren:

• Vereiste AIR-runtimeversie • Toepassingsidentiteit • Installatie- en programmamenumappen • Eerste inhoud en venstereigenschappen • Pictogrambestanden van de toepassing • Of uw toepassing een aangepaste update-UI heeft • Of uw toepassing kan worden aangeroepen door SWF-inhoud die in de browser van de gebruiker wordt uitgevoerd • Bestandstypekoppelingen

Indicatie van de vereiste AIR-versie Met de kenmerken van het hoofdelement van een toepassingsdescriptorbestand, application, wordt de vereiste AIRruntimeversie aangegeven:

ONTWIKKELING VAN ADOBE AIR 1.5-TOEPASSINGEN MET FLASH CS4 PROFESSIONAL 47 Eigenschappen van AIR-toepassingen instellen

xmlns De AIR-naamruimte, die u als de standaard XML-naamruimte moet definiëren. De naamruimte verandert bij elke grote release van AIR (maar niet bij kleine patches). Het laatste segment van de naamruimte, bijvoorbeeld "1.5", geeft de runtimeversie aan die de toepassing nodig heeft. U moet de naamruimte instellen op AIR 1.5 ("http://ns.adobe.com/air/application/1.5") als uw toepassing gebruikmaakt van nieuwe AIR 1.5-functies. Voor op SWF gebaseerde toepassingen, bepaalt de in de toepassingsdescriptor opgegeven AIR-runtimeversie de maximale SWF-versie die kan worden geladen als de eerste inhoud van de toepassing. Toepassingen waarin AIR 1.0 of AIR 1.1 wordt opgegeven, kunnen alleen SWF9-bestanden (Flash Player 9) gebruiken als eerste inhoud zelfs als de AIR 1.5-runtime wordt gebruikt. Toepassingen waarin AIR 1.5 wordt opgegeven, kunnen SWF9- of SWF10-bestanden (Flash Player 10) gebruiken als eerste inhoud. De SWF-versie bepaalt welke versie van de AIR- en Flash Player-API's beschikbaar zijn. Als een SWF9-bestand wordt gebruikt als de eerste inhoud van een AIR 1.5-toepassing, heeft die toepassing alleen toegang tot de AIR 1.1- en Flash Player 9-API's. Bovendien hebben gedragswijzigingen die zijn aangebracht in bestaande API's in AIR 1.5 of Flash Player 10 geen effect. (Belangrijke wijzigingen in API's met betrekking tot veiligheid zijn een uitzondering op dit principe en kunnen retro-actief worden toegepast op huidige en toekomstige patches van de runtime.) Voor op HTML gebaseerde toepassingen, bepaalt alleen de in de toepassingsdescriptor opgegeven runtimeversie welke versie van de AIR- en Flash Player-API's beschikbaar zijn voor de toepassing. Het HTML-, CSS- en JavaScript-gedrag wordt altijd bepaald door de versie van Webkit die wordt gebruikt in de geïnstalleerde AIR-runtime, en niet door de toepassingsdescriptor. Als een AIR-toepassing SWF-inhoud laadt, is de versie van de AIR- en Flash Player-API's die beschikbaar zijn voor die inhoud afhankelijk van hoe de inhoud wordt geladen. In de volgende tabel wordt aangegeven hoe de API-versie wordt bepaald op basis van de laadmethode: Hoe de inhoud wordt geladen

Hoe de API-versie wordt bepaald

Eerste inhoud, op SWF gebaseerde toepassing

SWF-versie van het geladen bestand

Eerste inhoud, op HTML gebaseerde toepassing Naamruimte van de toepassingsdescriptor SWF geladen door SWF-inhoud

Versie van de ladende inhoud

SWF-bibliotheek geladen door HTML-inhoud met <script>-tag

Naamruimte van de toepassingsdescriptor

SWF geladen door HTML-inhoud door AIR- of Flash Player-API's (zoals flash.display.Loader)

Naamruimte van de toepassingsdescriptor

SWF geladen door HTML-inhoud met

Ontwikkeling van ADOBE AIR 1.5-toepassingen met ADOBE FLASH CS4 PROFESSIONAL

de Finibus Bonorum et Malorum

Source

Target

Drop Files Here

de Finibus Bonorum et Malorum

Window X:
Window Y:

Ontwikkeling van ADOBE AIR 1.5-toepassingen met ADOBE FLASH CS4 PROFESSIONAL

Recommend Documents

de Finibus Bonorum et Malorum

Source

Target

Drop Files Here

de Finibus Bonorum et Malorum