docs/readme-simulator.txt

   1 Funambol BlackBerry Plug-in Community Edition v. 3.0.8
   2
   3 HOW TO run the Funambol Plug-in on the BlackBerry Simulator
   4 ================================================================================
   5
   6 1. Download and install the BlackBerry Java Development Environment (JDE) 4.2.0
   7    from http://na.blackberry.com/eng/developers/downloads/jde.jsp
   8
   9 2. Copy
  10
  11        - funambol_blackberry_plugin.cod
  12        - funambol_blackberry_plugin.csl
  13        - funambol_blackberry_plugin.cso
  14        - funambol_blackberry_plugin.debug
  15        - funambol_blackberry_plugin-1.debug
  16        - funambol_blackberry_plugin.jar
  17
  18 in [Research_In_Motion_HOME]\BlackBerry JDE 4.2.0\simulator
  19
  20 3. Start the Simulator (Start > Programs > Research In Motion >
  21    BlackBerry JDE 4.2.0 > Device Simulator)
  22
  23 4. The application will be installed in the Simulator as "Funambol 3.0.8".
  24
  25 5. Launch the application and configure it.
  26
  27 6. Start the synchronization selecting the "Synchronize" manu item.
  28
  29 7. Test the application
  30
  31 Note: If you use the BlackBerry MDS Simulator, be aware that it listens to
  32 connections on the TCP port 8080. This may conflict with other applications,
  33 such as Tomcat or the Funambol DS Server bundled edition.
  34
  35
  36 NOTE
  37 ====
  38
  39 (This information is no longer up-to-date, and is maintained here only for
  40 historical purposes)
  41
  42 - BlackBerry with OS version less than 4.0.2 does not support multiple address
  43 recognition. Applies to: BlackBerry OS version earlier than 4.0.2 and Sync4j
  44 BlackBerry Synchronizer version earlier than 1.1.5, Contact Database
  45
  46 Description: Due to the limitations of the BlackBerry OS in versions earlier
  47 than 4.0.2, the BlackBerry does not support the multiple address field
  48 recognition that is necessary for synchronization. With version 4.0.2, the PIM
  49 functionality was enhanced where additional access to fields was granted. In
  50 order to take advantage of this, version 4.0.2 must be installed onto the
  51 BlackBerry handheld. In addition to 4.0.2 (or higher) for the BlackBerry, you
  52 must have version 1.1.5 or higher of the Sync4j BlackBerry Client.
  53
  54 What this means is that if you have version 4.0.2 or higher of the BlackBerry OS
  55 and version 1.1.5 or higher of the Sync4j BlackBerry Synchronizer, then your
  56 address data will be synchronized. If you have version 4.0.0.x or 4.0.1.x of the
  57 BlackBerry OS and version 1.1.5 or higher of the Sync4j BlackBerry Synchronizer,
  58 then the address data will be ignored in the synchronization. In the latter
  59 scenario, no address data would be updated to or from the Portal to your
  60 BlackBerry device to avoid data compromisation.
  61
  62 If you do not have either of the previously described combinations of BlackBerry
  63 OS and Sync4j BlackBerry Synchronizer software, then we advise that you do not
  64 synchronize your contacts unless you have no address data or only work
  65 addresses. Otherwise, due to the BlackBerry OS's inability to recognize multiple
  66 addresses, your address data may be compromised, i.e. you may lose address data
  67 when syncing back from the Portal to your device.
  68
  69 To install or upgrade to the latest version of the Sync4j BlackBerry
  70 Synchronizer, please visit the downloads page.
  71
  72 - BlackBerry OS (API) does not support web page recognition. Applies to:
  73 BlackBerry OS version 4.0.2 and all earlier versions, Contact Database
  74
  75 Description: Due to the limitations of the BlackBerry OS (API) in version 4.0.2
  76 and all earlier versions, the BlackBerry does not support the web page field
  77 recognition that is necessary for synchronization. Therefore, until BlackBerry
  78 adds this field to their API, it cannot be synchronized by the Sync4j BlackBerry
  79 Synchronizer. Thus, when synchronizing your data, the web page data will not be
  80 passed back and forth between your device and the Portal. This field data will
  81 remained unchanged.