Appendix A: AIR Command-Line Tools

From Blognone

Jump to: navigation, search

ชุด AIR SDK รวมเครื่องมือแบบคอมมานด์ไลน์มาให้ดังนี้:

  • ADL
  • ใช้เรียกและทดสอบแอพพลิเคชัน AIR โดยไม่ต้องติดตั้งก่อน
  • ADT
  • ใช้ทำแพกเกจแอพพลิเคชัน AIR สำหรับแจกจ่าย

ในภาคผนวกนี้จะแสดงตัวเลือกต่างๆ สำหรับเครื่องมือสองตัวนี้ สำหรับตัวอย่างการใช้งาน ดูได้ในบทที่ 2

ADL

ADL เป็นเครื่องมือแบบคอมมานด์ไลน์ที่ใช้เรียกแอพพลิเคชันแบบ AIR โดยไม่จำเป็นต้องติดตั้งแอพพลิเคชันตัวนั้นลงในเครื่อง ADL จึงมีประโยชน์ต่อการทดสอบแอพพลิเคชัน

โดยทั่วไปแล้ว คุณจำเป็นต้องส่งพารามีเตอร์เพียงตัวเดียวให้ ADL นั่นคือ ตำแหน่งของไฟล์อธิบายแอพพลิเคชัน (application descriptor file) หรือไฟล์ที่นามสกุล .xml นั่นเอง

adl application.xml

สำหรับคำสั่งที่เป็นไปได้ทั้งหมดของ ADL คือ

adl ( -runtime <path-to-runtime-dir> )? <path-to-app-xml> <path-to-root-dir>? ( -- ... )?

ตารางต่อไปนี้อธิบายอาร์กิวเมนต์ต่างๆ ของ ADL

ตัวเลือก คำอธิบาย
-runtime อาร์กิวเมนต์เพื่อระบุไดเรคทอรีที่มีรันไทม์​ AIR (ไม่บังคับใส่)
path-app-xml ตำแหน่งของไฟล์อธิบายแอพพลิเคชันที่ต้องการเรียกใช้งาน
path-to-root-dir ตำแหน่งของไดเรคทอรีที่มีไฟล์อธิบายแอพพลิเคชันอยู่ (ไม่บังคับใส่)
-- อาร์กิวเมนต์อื่นๆ นอกเหนือจากนี้ จะถูกส่งต่อไปยังแอพพลิเคชันในฐานะอาร์กิวเมนต์ตั้งต้นของแอพพลิเคชัน อาร์กิวเมนต์พวกนี้สามารถเรียกใช้ได้โดย InvokeEvent

ADT

ADT เป็นเครื่องมือแบบคอมมานด์ไลน์เพื่อใช้สร้างแพกเกจของแอพพลิเคชันที่ต้องการแจกจ่าย ไฟล์แพกเกจเหล่านี้สามารถนำไปติดตั้งและใช้งานได้

โดยทั่วไป คุณเรียกใช้ ADT ในรูปแบบดังนี้

adt -package HelloWorld.air application.xml HelloWorld.swf

ในตัวอย่างนี้ ADT จะสร้างแพกเกจชื่อ HelloWorld.air โดยใช้ข้อมูลจาก application.xml ซึ่งเป็นไฟล์อธิบายแอพพลิเคชัน

คำสั่งที่เป็นไปได้ของ ADT คือ

adt -package <air-file> <app-xml> <fileOrDir>* ( -C <dir> <fileOrDir>+ )*

ตารางต่อไปนี้อธิบายอาร์กิวเมนต์ต่างๆ ของ ADT

ตัวเลือก คำอธิบาย
-package อาร์กิวเมนต์แรกสุดต้องเป็น -package
air-file ตำแหน่ง (แบบสมบูรณ์หรือสัมพัทธ์) ของแพกเกจ AIR ที่ ADT จะสร้างขึ้น
app-xml ตำแหน่ง (แบบสมบูรณ์หรือสัมพัทธ์) ของไฟล์อธิบายข้อมูลแอพพลิเคชัน
fileOrDir ต้องใส่ชื่อไฟล์หรือไดเรคทอรีอย่างน้อยหนึ่งชื่อเพื่อรวมเข้าไปในแพกเกจ ถ้ามีมากกว่าหนึ่งให้คั่นด้วยช่องว่าง
ถ้าระบุเป็นชื่อไดเรคทอรี ไฟล์ทั้งหมดในไดเรคทอรีนั้นรวมถึงไดเรคทอรีย่อยจะถูกรวมเข้าไปในแพกเกจ แต่ไฟล์ที่ถูกตั้งเป็น hidden โดยระบบจะไม่ถูกรวม
ถ้ามีไฟล์ที่ชื่อเหมือนกับที่ระบุในพารามีเตอร์ <app-xml> ข้างต้น ADT จะไม่สนใจไฟล์นั้น และไม่รวมเข้าไปในแพกเกจอีก
ไฟล์และไดเรคทอรีเหล่านี้จะถูกคัดลอกไปในไดเรคทอรีของแอพพลิเคชันเมื่อทำการติดตั้ง
-C <dir> เปลี่ยนตำแหน่งของ root directory สำหรับไฟล์และไดเรคทอรีที่ระบุในคอมมานด์ไลน์