Flash CS3 Documentation

Developing Flash Lite 2.x Applications > Developing Flash Lite Applications for BREW > Publishing Flash Lite files for BREW > Using the BREW Publisher wizard to publish application files

Using the BREW Publisher wizard to publish application files

The following steps assume that you already created and saved your application files in Flash. If you did not yet save your FLA file, the BREW Publisher Wizard prompts you to save it.

To use the BREW Publisher wizard to publish application files:

1. In Flash, select File > Publish Settings.

   The Publish Settings dialog box appears.

2. On the Formats tab, select Flash (.swf) if it is not already selected.

   You can deselect all other file types, because only the SWF file is needed to generate the BREW applet.

3. On the Flash tab, from the Version list, select a supported version of the player (Flash Player 7 or earlier, or any version of Flash Lite), and then select any of the versions from the ActionScript version list (all ActionScript versions are supported).
4. From the Post-Processor list near the bottom of the Flash tab, select Flash Lite for BREW.

   NOTE

   If the Post-Processor list does not appear on the Flash tab, check the instructions in Setting up your system for BREW to ensure that you correctly installed Flash Lite 2.1 for BREW. The Post-Processor list appears only after the software is installed.

5. Click Settings to the right of the Post-Processor list to display the BREW Publisher wizard.
6. (Required) Use the input fields on the Identify Applet screen to specify a unique class ID and name for your BREW applet.

   The following table lists detailed information about these fields. When you are finished specifying your applet's class ID and name, click Next to continue.

   Field name	Field contents
   Class ID	This field is prepopulated with a randomly generated value as a default. Replace this value with your certified class ID if you have one. A class ID is a unique 32-bit identification code (8-digit hexadecimal value), which the BREW interface creation mechanism uses. For testing on a local system, you can use the randomly generated default (provided it is unique), although QUALCOMM must issue a unique ID for applications intended for distribution. For more information on obtaining class ID files, see the BREW website.
   Applet Name	This field is prepopulated with the root portion of the name of the FLA file that is currently active. For example, if the active FLA file is called BREW.fla, the applet name is BREW. The name you enter in this field is displayed in the BREW Application Manager on the target device. Use the following guidelines for Applet names: Applet names must be all lowercase, and must begin with an alphabetic character. Numbers are allowed, but not as the first character. The underscore character is the only special character allowed, and it may not be the first character of the name. The maximum length of the name varies depending on the device. For information, see the device specifications on the BREW website.

7. (Optional) Use the Include Applet Information screen to enter information that you want to publish along with your BREW applet.

   The information that you enter here is stored in your applet's MIF file. The following table lists detailed information about each field. When you are finished specifying your information, click Next to continue.

   Field name	Field contents
   Author	Enter the applet author's name (23 characters maximum).
   Version	Enter the applet version (23 characters maximum).
   Copyright	Enter the copyright information (23 characters maximum).
   Domain URL	Enter the fully qualified domain for your applet, ending with a trailing slash (example: http://www.example.com/). The applet's domain controls which information the applet has access to at run time. In earlier versions of the Flash player, SWF files from similar domains (for instance, www.exampleapps.com and www.examplegames.com) could communicate freely with each other and with other documents. In Flash Player 7 and later, the domain of the data to be accessed must match the data provider's domain exactly for the domains to communicate. For more information about domains and security, see the Flash documentation's topics on security, cross-domain security, and allowing data access between cross-domain SWF files.
   Application Type (Application or screen saver)	Specifies whether the BREW applet you are creating is an application or a screen saver. For more information about how screen savers differ from applications, go to the BREW website and navigate to Developer FAQs > BREW Tools > MIF Settings > Screensaver.

8. (Optional for testing your application, but mandatory for applications that must pass True BREW Testing) Use the Applet Icons screen to enter or browse for the name and location of one or more icons for your applet.

   Supported file types are: JPEG, BMP, PNG, and BCI (BREW Compressed Image). These icons are displayed along with the applet's name in the BREW Application Manager on the target device. When you are finished specifying your icons, click Next to continue.

   Field name	Field contents
   Small icon	Image file for small icon (displayed on device). Maximum size: 16 x 16.
   Medium icon	Image file for medium icon (displayed on device). Maximum size: 26 x 26.
   Large icon	Image file for large icon (displayed on distribution server am some devices). Maximum size: 65 x 42.

9. Use the Define Output Settings screen to specify the locations in which to publish files for the BREW Simulator and the target device.

   These fields are populated with default values derived from your SWF file's location, combined with the applet's name and folder names (simulator and device) that indicate which files to use for testing and which files to upload to the device. You can accept the defaults, or you can specify different output locations. When you are finished, click Next to continue.

   Field name	Field contents
   For Simulator MIF folder Applet folder	Contains the files you need to test your applet by using the Simulator tool in the BREW SDK. For further information about the expected file locations and folder structure, see the documentation for the BREW Simulator on the BREW website.
   For Device	Contains the files you upload to the BREW device. For more information about how folder structures differ according to the version of BREW supported by the target device, see Uploading files to BREW devices.

10. Use the Summary of Your Selections screen to review the applet settings you selected.

    To change any of these settings, use the Back button to return to previous screens and make changes. When your settings are complete, check or uncheck the box at the bottom of the screen to specify whether to display the wizard again when you publish, and then click Finish to save your settings.

    Field name	Field contents
    Summary of Your Selections	Displays a list of all of your settings to review.
    Do not show this wizard on publish	Controls whether to display the wizard again when you publish the applet files, or trigger the publishing process without redisplaying the wizard. Note that you can always access the wizard regardless of this setting by displaying the Publish Settings dialog box and clicking the Settings button to the right of the Post-Processor list.

11. Click OK to save your settings, and then select File > Publish Settings again. The Publish Settings dialog box appears.

    NOTE

    This step is required only the first time you select Flash Lite for BREW from the Post-Processor list in a given file. Thereafter, you can publish without clicking OK first.

12. Click Publish to publish your files to the locations you specified using the wizard.

Flash CS3