| developer.brewmp.com developer.brewmp.com

Developer

Migrating Applications from BREW to Brew MP

Migrating applications from BREW to Brew MP

Base version:

Brew MP 1.0

This document describes the steps needed to convert a legacy BREW application (such as a BREW 3.x or 4.x application) to a Brew® Mobile Platform (Brew MP) application that can be compiled and executed with the Brew MP tools.

Qualcomm recommends that migration of a legacy BREW application be performed by someone familiar with the application source code and the resources it uses.

This technology guide describes the following:

  • Changes to BREW source files for Brew MP
  • Changes to BREW project files for Brew MP
  • Conversion of BREW resource files into Brew MP resource files
  • Importing a BREW project into Visual Studio

For Eclipse and command-line users, migrating applications from BREW to Brew MP is a manual process. If you develop applications using either Eclipse or the command line, follow all of the steps outlined in this document to migrate applications from BREW to Brew MP.

For Visual Studio users, Brew MP's Visual Studio Plugin automates many of the required tasks. To migrate applications using the Visual Studio Plugin, see Import a BREW project. Visual Studio users may also follow the steps to migrate projects manually.

For more information on the content of Brew MP resource files, see the Resource File and Markup Reference. This guide is available in the Brew MP SDK and on the Brew MP website.

PIM Technology Guide

PIM Technology Guide for Developers for Manufacturers

Base version:

Brew MP 1.0.1

Document number:

HT80-VT500-151 Rev. D

HT80-VT500-152 Rev. D

Date published:

April 30, 2012

The Personal Information Management (PIM) Technology Guide details information needed for developers to work with PIM, which is one of the Brew MP database components. Each of the database components listed below has a technology guide devoted to it, which describes the interfaces included in Brew ® MP:

  • Personal Information Management (PIM) which includes these database access features/capabilities:
    • Contacts
    • Call History
    • Calendar
    • Message Store
    • Personal Data Interchange (PDI)
  • Gallery
  • Timezone
  • Database Connection (dbc) with a port of SQLite.

    A database connection allows client software to talk to database server software. It is an API that defines how a client may access a database. It provides methods for querying and updating data in a database. dbc is oriented towards relational databases, whether on the same machine or not.

This technology guide only describes the PIM databases.

For device manufacturers, this document also describes device integration for PIM.

Connect Technology Guide

Connect Technology Guide for Manufacturersfor Developers

Base version:

Brew MP 1.0

Document number:

HT80-VT500-188 Rev. C

HT80-VT500-187 Rev. C

Date published:

April 12, 2012

This document provides an overview of Brew® MP device connection. Brew MP's Connect is a technology for interacting with devices that provides fast, secure, and powerful access to the device. Tools that leverage Connect can interact with both Legacy Brew and Brew MP Simulators and physical devices.

Developer Mode is the action of putting a device into a state that supports development with the Brew MP SDK Tools.

There are three technologies (protocols) for communicating with a Brew MP device:

  • Connect over Gateway
  • Connect over BTIL
  • Connect over DIAG

While they all share certain functionality, such as the ability to copy files, they differ in implementation and extensibility philosophies. This Technology Guide provides an overview of these Connect technologies and Developer Mode.

Application Management Technology Guide

Application Management Technology Guide for Manufacturers for Developers

Base version: Brew MP 1.0
Tested version: Brew MP 1.0
Phone tested: No
Document number:

HT80-VT500-4 Rev. B

HT80-VT500-5 Rev. B

Date published: December 14, 2011

This technology guide describes Brew ® Mobile Platform (Brew MP) application management support, including the following interfaces:

  • Window history (IWindowHistory)
    • Enumerate all windows in the system
    • Obtain information about specific windows
    • Receive notifications of changes to window history
  • Application history (IAppHistory)
    • Navigate through entries in the history list
    • Obtain the classID of a history entry
    • Set or retrieve data stored by the system when the application is suspended
    • Close the application history entry
    • Insert a new entry into the history
  • Application control (IAppletCtl)
    • Start and stop applications
    • Browse files or URLs; Brew MP loads the application associated with the file or URL
    • Enumerate all currently running applications
    • Query the state (foreground, suspended, background) and memory usage of running applications
This guide also discusses windowed versus nonwindowed applications, how Brew MP maintains the application stack, and the various application states.

Fonts Features Technology Guide

Base version:

Brew ® MP 1.0.4

Brew MP supports fonts for Brew MP applications by providing a bitmap font engine and TrueType font engines to allows applications to create either bitmap or TrueType fonts. This guide describes the Brew MP font engines and how to use them in applications. It shows example code for the following scenarios:

  • Using TrueType fonts
  • Using TrueType fonts with fonts_IFactory
  • Using bitmap fonts with Brew MP
  • Creating a custom TrueType font extension
  • Creating a custom LinkedTrueType font extension
  • Creating a custom bitmap font extension
  • Creating and using a font with a text widget
  • Creating and using a font with a static widget
  • Providing additional fonts in an application

Sample code

There are several sample applications on the Brew MP website with this guide:

  • c_bfeprimer_app - shows how to display text using bitmap fonts, TrueType fonts, and TrueType fonts with a static widget and a text widget.
  • c_samplebitmapfont_app - shows how to use a bitmap font extension in an application.
  • c_samplebitmapfont_extension - provides an example of a bitmap font extension.
  • c_sampletruetypefont_extension - provides an example of a TrueType font extension.

Networking Technology Guide

Networking Technology Guide for Manufacturersfor Developers

Base version:

Brew MP 1.0.2

Document number:

HT80-VT500-42 Rev. F

HT80-VT500-43 Rev. F

Date published:

September 8, 2011

The Brew MP™Networking Feature Family provides support for

  • Network management
  • TCP/IP (Basic Data Networking)
  • DNS operations
This technology guide lists the APIs necessary to implement some of these features and gives interface implementation and device configuration information for each. Some basic information is also included such as interface descriptions and usage, and in many cases, you are referred to already existing Brew MP documents that give more detail. Also included is information on ISSL, which provides a mechanism for secure communication, IWeb, which provides the context in which web transactions are conducted, and PDPSettings, a group of settings that define the packet data profile.

In the Device Integration section, there is information for OEMs on how to disable QoS and Multicast in the OEM layer if needed.

Sample code

The following sample code is provided with this guide on the Brew MP website, and some of the examples shown in this document are taken from this sample code:

  • c_mynetworksample.zip

  • c_oemsslroots_Brew4.x_o.zip (for Brew 4.x only)

Creating Device Profiles Technology Guide

Creating Device Profiles Technology Guide

Base version: Brew® MP 1.0.2
Document number: HT80-VT500-160 Rev. D
Date Published: April 5, 2012

Brew MP offers two ways to create device profiles that contain relevant information and files needed to create simulation targets:

  • This technology guide provides detailed instructions on creating a device profile.
  • As an alternative to the instructions in this technology guide, the Profile Creator tool allows you to quickly create custom device profiles, without purchasing any third-party tools. (See the Brew MP SDK Toolset and the Tools Reference for more information.)

Timezone Technology Guide

Timezone Technology Guide for Developers for Manufacturers

Base version:

Brew MP 1.0.2

Document number:

HT80-VT500-153 Rev. B

HT80-VT500-154 Rev. B

Date published:

August 26, 2011

The Timezone Technology Guide details information needed for developers to work with timezone, one of the Brew MP database components. Each of the database components listed below has a technology guide devoted to it, which describes the interfaces included in Brew MP:

  • Personal Information Management (PIM) which includes these database access features/capabilities:
    • Contacts
    • Call History
    • Calendar
    • Message Store
    • Personal Data Interchange (PDI)
  • Gallery
  • Timezone
  • Database Connection (dbc) with a port of SQLite. A database connection allows client software to talk to database server software. It is an API that defines how a client may access a database. It provides methods for querying and updating data in a database. dbc is oriented towards relational databases, whether on the same machine or not.

For device manufacturers, this document also describes device integration for timezone.

Gallery Technology Guide

Gallery Technology Guide for Developers for Manufacturers

Base version:

Brew® MP 1.0.2

The Gallery Technology Guide details information needed for developers to work with Gallery, which is one of the Brew MP database components. Each of the database components listed below has a technology guide devoted to it, which describes the interfaces included in Brew MP:

  • Personal Information Management (PIM)includes these database access features/capabilities:
    • Contacts
    • Call History
    • Calendar
    • Message Store
    • Personal Data Interchange (PDI)
  • Gallery
  • Timezone
  • Database Connection (dbc) with a port of SQLite.

    A database connection allows client software to talk to database server software. It is an API that defines how a client may access a database and provides methods for querying and updating data in a database. dbc is oriented towards relational databases, whether on the same machine or not.

For device manufacturers, this document also describes device integration for Gallery.

Widgets Technology Guide

Widgets Technology Guide for Manufacturers for Developers

Base version:

Brew MP 1.0
Document number:

HT80-VT500-103 Rev. D

HT80-VT500-104 Rev. D

Date published: January 2, 2012

This technology guide covers Brew ® MP UI Widgets. A widget is an extension of Brew MP and uses the Brew MP APIs to provide a framework for developers to quickly build a highly customized UI. This guide provides information about widget views, models, and controllers, as well as the widgets themselves and how to use them.

The following diagram shows the Brew MP application environment, which provides the foundation for applications running on Brew MP, and supports core application services such as UI, which includes Widgets.

Pages

Subscribe to developer.brewmp.com RSS