Branding sample setup instructionsAdded by IBM on October 4, 2010 | Version 1 (Original)
|Before you can run the sample, you must first import the sample into your workspace and launch the test runtime.
Before you can run the sample, you must first import the sample into your workspace and launch the test runtime.
Follow these steps:
- To import the sample:
- Select File > Import.
- From the Import Wizard, select General and then select Existing Projects into Workspace. Click Next.
- Select the Archive file radio button.
- Enter the name of the sample jar file, branding.jar, or browse to the com.ibm.rcp.tools.samplegallery2 plug-in directory and select the jar file from the archive directory.
- The dialog shows the projects present in the archive jar file. Select Finish to install the projects into your workspace.
- To launch the test runtime:
- Select Run > Run Configurations... from the main menu.
- Select Client Services and click New.
- Type a unique name for your configuration, such as Branding.
- Select the Plug-ins tab and verify that the com.ibm.rcp.samples.personality.branding plug-in is selected.
- Select the Arguments tab and verify that –console is in the Program Arguments field.
- In the Arguments tab, add the following to the VM Arguments text field:-Dosgi.splashPath=file:/workspace_location /com.ibm.rcp.samples.personality.branding, where workspace_location specifies the location of your workspace.
- Select the Main tab and select com.ibm.rcp.samples.personality.branding.SopwithLlamaProduct.
- Click Apply and then Run to launch the Lotus® Expeditor workbench.
- To export the branding sample and use the new branding in a separately-installed runtime, follow these steps:
To run the sample in a separately-installed Lotus Expeditor runtime:
- Ensure that you have access rights to install a feature into a shared directory and update the rcplauncher.properties file.
- To create an update site project, select File > New > Project and then select Update Site Project.
- From the Site Manifest Editor, select Add Feature... and add com.ibm.rcp.samples.personality.branding.feature.
- Select the feature, and click Build to build the update feature and included plug-ins. The update site is now built.
- Install the feature into a separately-installed runtime. The new product identity is used on subsequent launches of the platform.
To remove your branding feature and return to the Lotus Expeditor default branding, follow these steps:
- To open the Application Management dialog, select File > Application > Application Management. A minimum of four sites are displayed.
- Locate the site ending with rcp/eclipse and expand this site.
- Select the Default Personality Branding feature and then select Disable. Confirm that you want to disable this feature. When prompted to restart, select No.
- Select the Default Personality Branding feature and then select Enable. Confirm that you want to enable this feature. When prompted to restart, select Yes. Note that if you cannot locate this feature, verify that the Show Disabled Features option is enabled.
- When the platform restarts, the Lotus Expeditor default branding is used again.
- You can now uninstall the branding feature that you previously installed on the platform.
Parent topic: Branding: XPD621
Running the sample
This sample defines a personality that brands the workbench.
Actions include the following:
- Displays Llamas on the splash screen.
- Displays a Llama icon and the text Sopwith Llama Smorgashboard in the title bar.
- Displays a Llama icon and the title of the running application in the banner bar.
- Displays the text About Sopwith Llama Smorgashboard as the About selection in the Help menu.
- Displays a Llama icon and the text About Sopwith Llama Smorgashboard in the title of the About dialog.
- Displays a Llama picture and the text Sopwith Llama Customer Smorgashboard in the About dialog.
- Adds View > Show > Banner to the menu bar so that you can toggle the display of the banner bar.
The sample application is not available in the launch list.Cause:
The com.ibm.rcp.samples.personality.branding plug-in is not present or does not resolve in the client platform.Action:
Verify that the com.ibm.rcp.samples.personality.branding plug-in is contained in the runtime. If the plug-in is present, check the status of the plug-in. Go to the Console view and use the b com.ibm.rcp.samples.personality.branding command. The second line of output indicates the plug-in status. If the status is not RESOLVED or ACTIVE, there is a problem with the plug-in and its dependencies. Use the diag com.ibm.rcp.samples.personality.branding command to identify any unsatisfied dependencies. Resolve any missing dependencies and restart the platform.