This guide is intended to provide basic instructions on using the UI Framework. It will take you through getting your PC set-up to use the UI Framework and create a HelloWorld app using Eclipse.

1. Create a new JamaicaCAR Xlet project with [File > New > Other...> JamaicaCAR > JamaicaCAR Xlet Project].
   Make sure the JamaicaCAR SDK is chosen as project JRE.

    

2. Make sure new project’s Java compiler compliance level is set to 1.8.

    

3. Create lib folder inside project root and place SharedLibrary_UIFrame_1.0.0.jar there.
   Add this jar to project classpath [Project Properties -> Java Build Path -> Libraries -> Add External JARs].
   Make sure the library is exported [Project Properties -> Java Build Path -> Order and Export].
   Note: the image references FCAComponents.jar and should be SharedLibrary_UIFrame_1.0.0.jar.

    

4. You will need a Kona implementation.
   You can create a ref-lib folder inside project root and place af_kona_lib.jar there.
   af_kona_lib.jar can be found in the HU file system. Add this jar to project classpath. Make sure the library is exported.

    

5. If you want to use an emulated Kona version you can download the current version here EmulatedKona4.1.0.zip
   or from Downloads in the Emulator & Simulator section.

    

6. Create new class (called HelloXlet for example, located at package com.fca.helloworld). Make it extend com.tweddle.fca.FCAXlet.

    

7. Register your HelloXlet class at src/xlet.properties which was generated while project creation - add a line xlet.mainClass=com.fca.helloworld.HelloXlet.

    

1. Create a new class (for example HelloForm). Make it extend com.tweddle.fca.FCAForm.

    

2. At your HelloXlet class override method mainFormClass() - make it return HelloForm.class. It’s a first form to be shown on xlet start:

   public class HelloXlet extends FCAXlet {
       
           @Override
           public Component createSplashScreen() {
            // TODO Auto-generated method stub
               return null;
           }
       
           @Override
           public String l10n() {
               // TODO Auto-generated method stub
               return null;
           }
       
           @Override
           public Class< ? extends FCAForm> mainFormClass() {
               return HelloForm.class;
           }
       
           @Override
           public String resourcesFileName() {
               // TODO Auto-generated method stub
               return null;
           }
       
           @Override
           public String theme() {
               // TODO Auto-generated method stub
               return null;
           }
       
       }
                           

3. The main entry form’s point is method protected void onCreate(Bundle params). Override it and setup the form (set title, layout, add components etc.).

   public class HelloForm extends FCAForm {
       
           @Override
           protected void onCreate(Bundle params) {
               setTitle("HelloForm");
       
               setLayout(new BorderLayout());
       
               Label label = new Label("HelloWorld");
               label.getUnselectedStyle().setAlignment(CENTER);
               Font font = ResourceManager.getInstance().getFont(42);
               label.getUnselectedStyle().setFont(font);
       
               addComponent(BorderLayout.CENTER, label);
           }
       
       }
                           

   NOTE: onCreate() method is called on UI thread. Do not run heavy task there. You may refer to Android framework Activity’s lifecycle as the
   FCA UI Components library is built on nearly the same pattern.

@Override
        public Component createSplashScreen() {
            Label bgImageLabel = null;
            InputStream is = null;
            try {
                // Load a background image from resources
                is = getClass().getResourceAsStream("/res/splash.png");
                Image splashImage = Image.createImage(is);
    
                // Construct a new label with the background image
                bgImageLabel = new Label(splashImage);
    
                // Set the label style
                Style style = bgImageLabel.getStyle();
                style.setBgColor(0);
                style.setBgTransparency(0);
                style.setAlignment(Label.CENTER);
                bgImageLabel.setVerticalAlignment(Label.CENTER);
            } catch (IOException e) {
                // ignored
            } finally {
                if (is != null) {
                    try {
                        is.close();
                    } catch (IOException e) {
                        // ignored
                    }
                }
            }
    
            return bgImageLabel;
        }
    }
                

TIP: Also you may run some long-lasting task on xlet start - override “public void onLoad()” in “HelloXlet” - it will be executed on BG thread.

1. To run the Xlet, go to [Run > Run configurations] and create a new JamaicaCAR Xlet run configuration. Set the Xlet Project.

    

2. Put the path to emulator font properties location: /fs/apps/fonts/font.properties
   or C:\fs\apps\fonts\font.properties

    

3. Set the verbosity level to 5 (TRACE) to see all of your logs.

    

4. Then the run configuration can be started. You should see an emulated image similar to the image below.