Flex compiler API指南（第二章）

第二章 日志和报告

Adobe Flex Complier API为您生成报告(Reports) 并提供在编译过程中的进度和日志等信息。

使用自定义日志

您可以使用编译器获取错误信息。您可以自定义一个logger并为这个application指派logger，告诉这个application您正在编译。
使用自定义日志的具体步骤如下：
1、新建一个J***A类，实现flex2.tools.oem.Logger接口；例如：

// java/SimpleLogger.java

import flex2.tools.oem.Message;

import flex2.tools.oem.Logger;

import java.util.*;

  

public class SimpleLogger implements Logger {

    SimpleLogger() {

        System.out.println("----------------------------------");

    }

    public void log(Message msg, int errorCode, String source) {

        System.out.println(msg);

        System.out.println("----------------------------------");

    }

}

这个类必须实现log方法，它有3个参数：message，errorCode和source。
2、在您的J***A应用里，调用接口的setLogger()方法为这个Applocation指派logger；例如：
application.setLogger(new SimpleLogger());
如果您没有调用setLogger()方法，则编译器记录log信息到标准输出。
3、编译并运行例子
4、测试这个logger，在您的例子中加入一些错误的语法；例如：

<?xml version="1.0"?>

<!-- apps/ErrorTestApp.mxml -->

<mx:Application xmlns:mx="http://www.adobe.com/2006/mxml">

    <mx:Script>

        // Generates a warning because there is no return type.

        public function doSomethingWrong() {

            // Generates an error because x lacks a type.

            var x;

        }

    </mx:Script>

    <mx:Label text="Hello World"/>

</mx:Application>

例子可能输入如下信息：
----------------------------------
ERROR: Loading configuration file
C:/home/dev/depot/flex/sdk/frameworks/flex-config.xml
--------------------------------------------------------------------
ERROR: return value for function 'doSomethingWrong' has no type
declaration.
----------------------------------
ERROR: variable 'x' has no type declaration.
----------------------------------
使用消息类中的getLevel()、getPath()，getLine()和getColumn()，您可以获得其他信息，比如错误级别(error level)和错误地点(location of error)，下面的例子比上面的例子输出了更多的信息：

// java/ComplexLogger.java

import flex2.tools.oem.Message;

import flex2.tools.oem.Logger;

import java.util.*;

import java.io.*;

  

public class ComplexLogger implements Logger {

    ComplexLogger() {

        String LOGFILENAME = "output.txt";

        try {

            System.setOut(new PrintStream(new 

                FileOutputStream(LOGFILENAME)));

        } catch (Exception e) { 

            System.out.println("There was an error creating 

                the log file.");

        }

        System.out.println("Ran at : " + new Date());

        System.out.println("----------------------------------");

    }

    public void log(Message msg, int errorCode, String source) {

        if (msg.getLevel() == "info") {

            // Suppress info messages.

        } else {

            System.out.println("ERROR  : " + errorCode);

            System.out.println("MESSAGE: " + msg);

            System.out.println("SOURCE : " + source);

            System.out.println("LEVEL  : " + msg.getLevel());

            System.out.println("PATH   : " + msg.getPath());

            System.out.println("LINE   : " + msg.getLine());

            System.out.println("COLUMN : " + msg.getColumn());

            System.out.println("----------------------------------");

        }

    }

}

不是所有的编译错误都有明确的解释。例如，在您的MXML代码中发生错误，就没有错误码，所以Logger返回 -1 。 而AS代码，无论何时，都会返回错误代码。
您也可以使用Report Class在编译正在执行的时候查看Message对象。

创建报告

Flex compiler API包括了对application、library或正在编译的项目创建报告的能力。在报告中，您可以包含应用的详细信息，信息包括链接、资源、依赖、库和资源绑定(resource bundle)等，也包括背景颜色，高度，宽度等应用程序的增量信息。
您可以用Application和Library对象的getReport()方法来获得报告。这个方法返回一个Report类实例，使用它就可以输出关于编译目标的信息。
在您使用Report类生成报告之前，您必须构建应用程序或库，这意味着您必须在调用任何报告t方法之前调用build()方法。
下面的例子将输出报告信息到标准输出：

// java/MyReportCompiler.java

import flex2.tools.oem.Application;

import flex2.tools.oem.Report;

import flex2.tools.oem.Configuration;

import flex2.tools.oem.Logger;

import java.io.*;

public class MyReportCompiler {

    public static void main(String[] args) {

        String assetRoot = "../assets/";

        String outputRoot = "../apps/";

        File[] themeFile = new File[] 

            {new File(assetRoot, "myTheme.css")};

        File[] libFile = new File[] 

            {new File(assetRoot, "MyComponents.swc")};

        try {

            Application application = new 

                Application(new File(outputRoot, 

                "TestAppWithAllAssets.mxml"));

            application.setOutput(new File(outputRoot, 

                "TestAppWithAllAssets.swf"));

            

            application.setLogger(new ComplexLogger());

            application.setProgressMeter(new MyProgressMeter());

            Configuration config = application.getDefaultConfiguration();

            config.setTheme(themeFile); 

            config.addLibraryPath(libFile);

            application.setConfiguration(config);

            application.build(true);              

            Report report = application.getReport();

            // Lists the image files that are embedded.

            System.out.println("/n/nEMBEDDED ASSETS: ");

            String[] cnames = report.getAssetNames(Report.COMPILER);

            for (int i=0; i<cnames.length; i++) {

                System.out.println(cnames[i]);         

            }

            // Lists the libraries that are used.

            System.out.println("/nLIBRARIES: ");

            String[] libs = report.getLibraryNames(Report.COMPILER);

            for (int i=0; i<libs.length; i++) {

                System.out.println(libs[i]);         

            }

                        // Lists source files, their definition names, and dependencies.

            System.out.println("/nSOURCE NAMES: ");

            String[] list = report.getSourceNames(Report.COMPILER);

            for (int i=0; i<list.length; i++) {

                System.out.println(list[i]);         

                String[] defs = report.getDefinitionNames(list[i]);

                System.out.println("DEFINITIONS: ");

                for (int j=0; j<defs.length; j++) {

                    System.out.println(defs[j]);         

                    

                    System.out.println("   DEPENDENCIES: ");

                    String[] deps = report.getDependencies(defs[j]);

                    for (int k=0; k<deps.length; k++) {

                        System.out.println("      " + deps[k]);         

                    }

                    System.out.println("   PREREQS: ");

                    String[] prereqs = report.getPrerequisites(defs[j]);

                    for (int k=0; k<prereqs.length; k++) {

                        System.out.println("      " + prereqs[k]);         

                    }

                }

            }   

            // Get application info.

            System.out.println("/nAPPLICATION INFO: ");

            System.out.println("   Background Color: " + 

                "0x" + Integer.toHexString(report.getBackgroundColor()).

                    toUpperCase());

            System.out.println("   Height          : " + 

                report.getDefaultHeight() + 

                " (" + 

                Math.round(100 * report.getHeightPercent()) + 

                "%)");

            System.out.println("   Width           : " + 

                report.getDefaultWidth() + 

                " (" + 

                Math.round(100 * report.getWidthPercent()) + 

                "%)");

            System.out.println("   Page Title      : " + 

                report.getPageTitle());

        } catch (Exception ex) {

            ex.printStackTrace();

        }

    }

}

输出信息大体如下：
EMBEDDED ASSETS:
C:/home/depot/EN/Docs/Flex/Flex2next/oem_kit/code/assets/bird-gray.gifC:/home/depot/EN/Docs/Flex/Flex2next/oem_kit/code/assets/bird-silly.gif
C:/home/depot/EN/Docs/Flex/Flex2next/oem_kit/code/assets/bird.gif
LIBRARIES:
C:/home/depot/EN/Docs/Flex/Flex2next/oem_kit/code/assets/MyComponents.swc
C:/home/dev/depot/flex/sdk/bundles/en_US/charts_rb.swc
C:/home/dev/depot/flex/sdk/bundles/en_US/framework_rb.swc
C:/home/dev/depot/flex/sdk/frameworks/libs/flex.swc
C:/home/dev/depot/flex/sdk/frameworks/libs/framework.swc
C:/home/dev/depot/flex/sdk/frameworks/libs/playerglobal.swc
SOURCE NAMES:
C:/home/depot/EN/Docs/Flex/Flex2next/oem_kit/code/apps/TestAppWithAllAssets
.mxml
DEFINITIONS:
TestAppWithAllAssets
DEPENDENCIES:
AS3
MyButton
MyLabel
mx.controls:Image
mx.controls:Label
mx.core:UIComponentDescriptor
mx.core:mx_internal
mx.events:PropertyChangeEvent
mx.styles:CSSStyleDeclaration
mx.styles:StyleManager
PREREQS:
mx.core:Application
APPLICATION INFO:
Background Color: 0x869CA7
Height : 375 (75%)
Width : 500 (100%)
Page Title : Test App With All Assets

使用报告查看消息(Message)

您也可以在编译期间获得消息信息，消息级别包括信息(info)，警告(warning)和错误(error)，您可以使用Reoprt类的getMessages()方法访问Message对象数组：

// java/MySimpleReportCompiler.java

import flex2.tools.oem.Application;

import flex2.tools.oem.Report;

import flex2.tools.oem.Message;

import java.io.*;

public class MySimpleReportCompiler {

    public static void main(String[] args) {

        try {

            Application application = new Application(new 

                File("../apps/ErrorTestApp.mxml"));

            application.setOutput(new File("../apps/ErrorTestApp.swf"));

            application.build(true);              

            Report report = application.getReport();           

            Message[] m = report.getMessages();            

            for (int i=0; i<m.length; i++) {

                System.out.println(m[i].getLevel().toUpperCase() + 

                    " MESSAGE " + i + ": " + m[i]);

            }            

        } catch (Exception ex) {

            ex.printStackTrace();

        }

    }

}

观察进度

Flex Complier API 包含一个进度尺，它可以让您轻松观察进度。
1、使用进度尺：

// java/MyProgressMeter.java

import flex2.tools.oem.ProgressMeter;

public class MyProgressMeter implements ProgressMeter {

    long before, after;

    MyProgressMeter() {

    }

    public void start() {

        before = System.currentTimeMillis();

        System.out.print("begin...");

    }

    public void end() {

        after = System.currentTimeMillis();

        System.out.println("done");

        System.out.println("Elapsed Time: " + (after - before) + "ms");

    }

    public void percentDone(int n) {

        System.out.print(n + "...");

    }

}

这个类必须实现start(), end() 和 persentDone()方法，这些方法加入了在编译过程中的计算时间的逻辑
2、在编译Flex应用程序的J***A应用中，调用setProgressMeter()方法为应用程序指派一个进度尺；例如：
application.setProgressMeter(new MyProgressMeter());
3、编译这个应用程序，进度尺大体输出如下：
begin...1...2...3...4...5...6...7...8...9...10...11...12...13...14...15
...16...17...18...19...20...21...22...23...24...25...26...27...28...29.
..30...31...32...33...34...35...36...37...38...39...40...41...42...43..
.44...45...46...47...48...49...50...51...52...53...54...55...56...57...
58...59...60...61...62...63...64...65...66...67...68...69...70...71...7
2...73...74...75...76...77...78...79...80...81...82...83...84...85...86
...87...88...89...90...91...92...93...94...95...96...97...98...99...100
...done