AVM2 - ASC编译器命令行基础

  1、ASC编译器简介

     avmshell执行了abc文件,并输出结果,后面跟的具体的参数主要是用于输出管理,而编译AS3文件的重任则落在了asc.jar上。     上一次我们提到如何简单地使用asc编译器编译.as文件生成.abc。然而Hello world永远都是那么的简单。

     那么这一节,我们就来重点看看这个 asc编译器。

     源码:flex-sdk/modules/asc/src

     成品:asc.jar

    主要用法和参数,输入java -jar asc.jar回车即可看到:

     asc {-AS3|-ES|-d|-f|-h|-i|-import <filename>|-in <filename>|-m|-p}* filespec     ……     ……


     2、制作asc.exe     当然,我们也可以把它制作成可执行的文件

     我们首先作一个asc.as,内容如下:

     package     {     import avmplus.System;     var cmdline = "java -jar asc.jar";

     if( System.argv.length > 0 )

        {

         cmdline += " " + System.argv.join( " " );

         }

     System.exec( cmdline );

    }

 

     然后,我们利用asc编译器:

     java -jar asc.jar asc.as回车

    输出   asc.abc, 205 bytes written

    这样,我们可以./avmshell asc.abc来代替java -jar asc.jar,以后就用avmshell来编译和执行文件了。

 

    当然,这样作还是不方便,那么,我们可以这样:

     java -jar asc.jar -exe asc.exe asc.as

     输出    asc.abc, 205 bytes written

    java.io.FileNotFoundException: asc.exe (No such file or directory)

        at java.io.FileInputStream.open(Native Method)

         at java.io.FileInputStream.<init>(FileInputStream.java:106)

         at macromedia.asc.embedding.Compiler.createProjector(Unknown Source)

         at macromedia.asc.embedding.Compiler.doCompile(Unknown Source)

         at macromedia.asc.embedding.Compiler.doCompile(Unknown Source)

         at macromedia.asc.embedding.Main.handleFile(Unknown Source)

        at macromedia.asc.embedding.Main.main(Unknown Source)

  asc.exe, 0 bytes written

 

      提示没有这个文件asc.exe生成失败。这可能是个BUG,呵呵,不过解决这个问题很简单,建立一个空的asc.exe就可以了:   cat /dev/null > asc.exe   然后java -jar asc.jar -exe asc.exe asc.as 输出

 asc.abc, 205 bytes written asc.exe, 213 bytes written

 

  好了,asc.exe生成完毕。这样,我们就可以使用这个asc.exe来代替java -jar asc.jar 了

  当然,在linux下没这么好的待遇,不过有一个asc.sh,就在flex-sdk/modules/asc/bin下

   至于这个神奇的avmplus.System包,它居然能对命令行操作,它的原型是

     public native static function exec(command:String):int

    也就是说他执行的native的本地代码,它脱离了AVM2的平台去执行了已经设计好的本地代码。大家翻开core目录下的任意.cpp和.as代码发现都有大量的native代码出现。

     其实大家在开发的时候,也会主义到,flex基类里也有很多native代码,比如常用的数字转型:Number(expression)。

     这类的本地代码主要安装在解释器内部,如Flash Player 以本机代码的形式实现。

     当然也可以是你自己的avmshell。或者自己的MyFlash Player或本地定制的AIR运行时环境。听到这很令人激动不是么?

     比如制作public native static function alert(text:String):void 在win下来执行

      MessageBoxW(NULL, text->c_str(), L"我的AIR", MB_ICONEXCLAMATION);

    在linux下执行其他的比如QMessageBox等。

 

       当然我们还能制作一些函数调用本地dll等,我们利用这些native代码,可以实现另一个Yahoo ! Widget桌面小件平台运行时环境。     不过大家别激动,关于这些内容,我们在以后的章节会继续详细讨论。

     性子急的朋友,可以现看看tamarine-tracing/shell/SystemClass.cpp

 

3、更复杂的编译:

     1)      -strict  treat undeclared variable and method access as errors

           意思是把没定义的变量和方法一律视为错误

 

     首先,我们还是以之前的demo为例子,只是这次我们加上参数-strict

     java -jar asc.jar -strict hello.as

     输出

     [Compiler] Error #1180: Call to a possibly undefined method print.

    hello.as, Ln 1, Col 1:

    print ("Hello world");

   ^    1 error found

    在编译hello.as时,我们并没有定义print方法,所以使用strict报错

    平时,在编译as文件的时候,一般asc会包含一些内建的方法,所以我们并不需要包含这些文件,但是如果我们使用-strict选项,则必须引用完全。

 

    2)-import <filename> = make the packages in the  specified file available for import

            意思是在指定的文件的packages包内添加import引用

     所以我们可以这样写上面的例子:

     java -jar asc.jar -strict -import ../../tamarin-tracing/core/builtin_full.abc -import ../../tamarin-tracing/shell/shell_full.abc  hello.as

        每一个要import的对象前都要写-import,路径要写对,在本文里,编译和执行的目录相对于tamarin项目是../../。

        输出        hello.abc, 69 bytes written

 

        还记得第一章编译的输出吗?不用-strict的输出是hello.abc, 84 bytes written,。可见,使用-strict后,尺寸缩小了。

                我们再来一个复杂点的例子, Test.as :

        package {

       public class Test {

              public function Test() {

                   trace("hello World");

             }

       }

   }

      编译 java -jar asc.jar Test.as

      却输出: [Compiler] Error #1017: The definition of base class Object was not found.

   Test.as, Ln 1, Col 1:

   package {

   ^ 1 error found

 

   为什么呢,是因为类声明全写为public class Test extend Object因为继承Object所以省略了,但是Object类编译时没有包含进来。

    我们可以 java -jar  asc.jar -import ../../tamarin-tracing/core/builtin_full.abc Test.as

    输出 Test.abc, 182 bytes written

    这个builtin_full.abc是什么呢,它是怎么构建的,答案是tamarin-tracing/core/builtin.py脚本,关于这个脚本,我们以后再详细讨论。

 

    3) -in  <filename> = include the specified filename        (multiple -in arguments allowed)

 

        编译时包含指定文件。允许多个in选项

       这个-in跟-import差不多,但也不完全一样。-import 等于是在package {} 里写import ,而-in是在编译过程中加入主文件的附属文件,即编译多个文件的意思。

 

      比如,再写一个TestImpl.as:

      package com {

         public class TestImpl {

                 public function TestImpl() : void {

                         var test : Test = new Test();

                }

         }

        new TestImpl();

     }

     然后编译这个文件:

 

     从2) 小节已知的知识我们可能要这样输入命令:

     java -jar asc.jar -import ../../tamarin-tracing/core/builtin_full.as -import Test.as TestImpl.as

     执行成功了,输出

     TestImpl.abc, 201 bytes written

    然而,运行它的时候,就出问题了:

         ./avmshell TestImpl.abc

   输出

         VerifyError: Error #1014: Class Test could not be found.

                at TestImpl$iinit()

                 at global$init()

 

    从输出信息来看,是Test类没有找到,但是,我们的确引入了Test.as了阿。

    原因是因为 -in选项,编译的时候并没有让Test.as加入到此次编译过程中,而只是-import了Test.abc,相当于在TestImpl里加了import  com.TestImpl;但Test.as并没有加入到项目中。

     这时,我们应该使用-in选项:

 

        java -jar asc.jar -import ../../tamarin-tracing/core/builtin_full.as  -in Test.as TestImpl.as

        输出

             TestImpl.abc, 384 bytes written

        字节明显比刚才的201 bytes多。

     现在我们执行它:

     ./avmshell TestImpl.abc

        输出

         hello World

 

 4)   -swf  classname,width,height[,fps] = emit a SWF file

      编译成为swf文件,格式为-swf 类名, 宽, 高, [祯率]

         大家记得,还有个mxmlc吧,这个也能编译swf,有什么区别呢?

         我们制作一个文件来测试一下,MyTest.as:

 

package {

   import flash.display.*;

   import flash.text.*;

  public class MyTest extends Sprite {

     public function MyTest() {

       var test:Test = new Test();

      var text = new TextField();

      text.width = 400;

      text.x = 0;

      text.y = 0;

      text.text = 'This is only a Test';

      addChild(text);

    }

   }

 } 我们编译这个文件mxmlc MyTest.as 输出/home/test/dev/tamarin/build/shell/MySprite.swf (856 bytes) 这样就OK了,我们可以用flashplayer测试结果:flex-sdk/in/player/lnx/flashplayer MySprite.swf回车屏幕显示This is only a test,控制台显示hello World 而我们用asc则是(为了方便,我已经不想用../../tamarin-tracing这类path了,直接把常用abc文件copy到当前目录下)

     java -jar asc.jar -import   -swf MyTest,400,300 -import builtin_full.abc -import playerglobal.abc -in Test.as MyTest.as

 输出 MySprite.swf, 830 bytes written

 

测试结果,除了背景色不同外,结果相同。

 关键是mxmlc读取flex-config.xml,而且更重要的是,它自动会寻找Test.as,而asc是不会的。

 

 6) 其他操作    关于其他操作,还请大家去看flex-sdk的源码和tamarin的avmshell项目代码,过后,我们也有详细的讨论,请大家关注 好了,今天的asc命令行编译工具就介绍到这里,接下来的内容,就让我们更深入tamarin一些吧。


你可能感兴趣的:(AVM2 - ASC编译器命令行基础)