The XDEV Mobile Kit allows you to access mobile devices from a server application developed with RapidClipse as well as the final deployment of hybrid apps.

• Tools - Allow you to deploy hybrid mobile apps and transfer them directly to mobile devices.
• API - Grants access to hardware and system functions of mobile devices via Vaadin.

Supported services

• Device buttons - App service

  /**
   * Add a button handler, e.g. for the back button
   */
  AppService.getInstance().addBackButtonHandler(event->{
      // Do something ...
      // and consume event so that it will not be processed in the default manner by the source which originated it.    
      event.consume();
  }); 

• Barcode scanner - Access to all barcode scanners. Some of the formats: QR, Data Matrix, UPC E/A, EAN 8/13, Code 128/93/39, CodeBar, ITF, RSS 14/Expanded, PDF417, MSI, Aztec

  /**
   * Use BarcodescannerService to scan a barcode.
   * Results are delivered asynchronously via callbacks.
   */
  
  /**
   * Opens the barcode scanner app.
   */
  void scan()
  {
      BarcodescannerService.getInstance().scan(this::barcodeScanned,this::onError);
  }
  
  /**
   * Success callback
   */
  void barcodeScanned(final BarcodeData barcode)
  {
      System.out.println(barcode.getFormat()+": "+barcode.getData());
  }
  
  /**
   * Error callback
   */
  void onError(final MobileServiceError error)
  {
      System.err.println(error.getMessage());
  }

• Camera
  • Access to photo and video function, front and back camera 
  • Direct transfer of images and videos 
  • Storage of pictures and videos on the device with later processing via file service. Optional: Picture/video, front/back camera, quality, file format
  • Access to image library

  /**
   * Use CameraService to take pictures, videos or to choose a file from an album.
   * Results are delivered asynchronously via callbacks.
   */
  
  /**
   * Opens the camera app.
   */
  void takePicture()
  {
      final CameraOptions options = CameraOptions.takeAndReturnPicture();
      CameraService.getInstance().getPicture(options,this::pictureTaken,this::onError);
  }
  
  /**
   * Success callback
   */
  void pictureTaken(final ImageData imageData)
  {
      // do something with taken picture
  }
  
  /**
   * Error callback
   */
  void onError(final MobileServiceError error)
  {
      System.err.println(error.getMessage());
  }

• Contacts
  • Browse the contact database
  • Select a contact
  • Edit and save a contact 

  /**
   * Use ContactsService to work with contacts.
   * Results are delivered asynchronously via callbacks.
   */
  
  /**
   * Shows the contact picker app
   */
  void pickContact()
  {
      ContactsService.getInstance().pickContact(this::contactPicked,this::onError);
  }
  
  /**
   * Finds contacts by name
   */
  void findContacts(String name)
  {
      final ContactFindOptions options = ContactFindOptions.byName(name);
      ContactsService.getInstance().find(options,this::contactsFound,this::onError);
  }
  
  /**
   * Success callback
   */
  void contactPicked(final Contact contact)
  {
      System.out.println(contact);
  }
  
  /**
   * Success callback
   */
  void contactsFound(final List<Contact> contacts)
  {
      System.out.println(contacts);
  }
  
  
  /**
   * Error callback
   */
  void onError(final MobileServiceError error)
  {
      System.err.println(error.getMessage());
  }

• File system - Reading access to the file system of the mobile device.

• Geolocation 
• Current position (lines of longitude and latitude as well as altitude)

• Tracking the position by motion data (direction and speed)

  /**
   * Use GeolocationService to acquire position information.
   * Results are delivered asynchronously via callbacks.
   */
  
  /**
   * Lookup the current position of the device
   */
  void getCurrentPosition()
  {
      GeolocationService.getInstance().getCurrentPosition(this::positionFound,this::onError);
  }
  
  /**
   * Success callback
   */
  void positionFound(final Position position)
  {
      System.out.println(position);
  }
  
  /**
   * Error callback
   */
  void onError(final MobileServiceError error)
  {
      System.err.println(error.getMessage());
  }

• NFC - Option to read and write NFC tags

  /**
   * Use NfcService to read and write NFC tags.
   * Results are delivered asynchronously via callbacks.
   */
  
  /**
   * Start listener
   */
  void startListening()
  {
      NfcService.getInstance().startNdefListener(this::ndefListenerCallback,this::startNdefListenerSuccess,this::onError);
  }
  
  /**
   * Stop listener
   */
  void stopListening()
  {
      NfcService.getInstance().stopNdefListener(this::stopNdefListenerSuccess,this::onError);
  }
  
  /**
   * Tag read callback
   */
  void ndefListenerCallback(final Ndef ndef)
  {
      final Tag tag = ndef.getTag();
      System.out.println(tag);
  }
  
  /**
   * Listener successfully registered
   */
  void startNdefListenerSuccess(final String message)
  {
      System.out.println(message);
  }
  
  /**
   * Listener successfully removed
   */
  void stopNdefListenerSuccess(final String message)
  {
      System.out.println(message);
  }
  
  /**
   * Error callback
   */
  void onError(final MobileServiceError error)
  {
      System.err.println(error.getMessage());
  }

• Vibration 
  • Simple vibration with variable duration, e.g. 1 sec.
  • Vibration patterns with variable duration and pauses, e.g. Vibration 0.5 sec, Pause 0.3 sec, Vibration 0.1 sec., etc.

  /**
   * Vibrates one second
  */
  VibrateService.getInstance().vibrate(1000);
  
  /**
   * Pattern: Vibrate 500 ms, pause 250 ms, vibrate 250 ms (Android only)
  */
  VibrateService.getInstance().vibrate(500,250,250);

Deploy mobile app

Mobile App Deployment