Updated BBM sample.

bbm/README.md

@@ -1,4 +1,15 @@
-This sample is based on the Jam Americas 2012 lab sample that was made available here:
-https://github.com/blackberry/BB10-WebWorks-Community-Samples/tree/master/bbm
+This application provides a look at **blackberry.bbm.platform** as well as **blackberry.invoke** APIs that will enable developers to leverage BlackBerry Messenger integration within their BlackBerry 10 applications.
 
-Refer to the original sample for more information regarding the UI implementation, however please note that the actual BBM API implementation has since changed, and this sample should be used for reference regarding functionality implementation.
+To separate the BBM functionality from the remaining application, all relevant BBM implementation was implemented in **bbm.js** while the remaining files are leveraged to configure UI components, and define actions (click event listeners) connecting those components to the API functionality.
+
+#Known Issues
+
+**blackberry.bbm.platform.self.setDisplayPicture**
+* Not currently working.
+* Can be replaced with the **Set Avatar** invocation.
+
+**Start Chat**
+* Should display Contact Picker if no **uri** is provided; not currently working.
+* Can be replaced with the **Share Text* invocation (provide empty **data** string.)
+* If a URI is provided that exists in the users's BBM Contact List, a chat will be immediately started; working as intended.
+* If a URI is provided that does not exist in the user's BBM Contact List, an invitation to join BBM will be sent instead; working as intended.

bbm/config.xml

@@ -19,40 +19,27 @@
 
 <widget xmlns="http://www.w3.org/ns/widgets"
         xmlns:rim="http://www.blackberry.com/ns/widgets"
-        version="1.0.0.895"
-        id="bbmsample"
+        version="1.0.0.0"
+        id="bbmapis"
         xml:lang="en">
 
 	<!-- Application details. -->
-    <name>BBM Sample</name>
-    <author>Research In Motion</author>
-
-	<!-- Application startup page. -->
+    <name>BBM APIs</name>
+    <author>Oros</author>
     <content src="index.html"/>
 
-	<!-- Application icon. -->
-	<icon src="appicon.png" />
-
-	<!-- Allow access to external URLs. -->
-    <access uri="*" subdomains="true" />
-
-	<!-- Do not cache content. -->
-    <rim:cache disableAllCache="true" />
-
-	<!-- Focus-based navigation for BBUI.js. -->
-	<rim:navigation mode="focus" />
-
-	<!-- Required permissions. -->
-	<rim:permissions>
-		<rim:permit>bbm_connect</rim:permit>
-	</rim:permissions>
-
 	<!-- Required features for BBUI.js. -->
 	<feature id="blackberry.app" />
 	<feature id="blackberry.app.event"/>
 	<feature id="blackberry.system.event" />
-	<feature id="blackberry.ui.dialog" />
-
+
 	<!-- Additional features. -->
 	<feature id="blackberry.bbm.platform" />
+	<feature id="blackberry.invoke" />
+	<feature id="blackberry.system" />
+
+	<!-- Required permissions. -->
+	<rim:permissions>
+		<rim:permit>bbm_connect</rim:permit>
+	</rim:permissions>
 </widget>