Specifying a Splash Screen

Java SE 6 offers splash screen support, either through a Java command-line option or a manifest entry in the application's JAR file. To take advantage of this Java SE feature in your application client, you can do one of the following:

• Create the appclient JAR file so that its manifest contains a SplashScreen-Image entry that specifies the path to the image in the client. The java command displays the splash screen before starting the ACC or your client, just as with any Java application.

• Use the new appclient ... -jar launch format, using the -splash command-line option at runtime or the SplashScreen-Image manifest entry at development time. See Running an Application Client Using the appclient Script.

• In the environment that runs the appclient script, set the VMOPTS environment variable to include the -splash option before invoking the appclient script to launch the client.

• Build an application client that uses the embeddable ACC feature and specify the splash screen image using one of the following:

  • The -splash option of the java command

  • SplashScreen-Image in the manifest for your program (not the manifest for the application client)

  See Using the Embeddable ACC.

During application (EAR file) deployment, the GlassFish Server generates façade JAR files, one for the application and one for each application client in the application. During application client module deployment, the GlassFish Server generates a single facade JAR for the application client. The appclient script supports splash screens inside the application client JAR only if you launch an application client facade or appclient client JAR. If you launch the facade for an application or the undeployed application itself, the appclient script cannot take advantage of the Java SE 6 splash screen feature.