“Money” by PTMoney/CC/flickr

Most people like to be rewarded for hard work. There are of course many ways in which people derive reward. Fame. Adoration. Legions of followers on Twitter. Free cookies. But perhaps the most prevalent and obvious is cold, hard cash.

With BlackBerry World, there are a number of ways to get money out of your investment in your BlackBerry 10 application. Today’s refresh of the BlackBerry 10 WebWorks SDK brings support for ourPayment Service. The Payment Service allows you to implement in-app purchases, either one-time purchases or subscription-based services. Now you can choose your monetization strategy for your BlackBerry 10 WebWorks application: paid download, freemium, in-app purchases, digital goods, etc.

Check out the API reference to get started.  You will immediately notice that there are a few new additions to the API compared to previous implementations in BlackBerry WebWorks, such as cancel subscription.

While payment should be enough to get your excited on its own, we also were able to sneak in some of the final bits of the BBM Social Platform – namely support for the Profile Box.  The Profile Box is a customizable box for your app that appears in the current user’s BBM profile. You can use it to broadcast achievements or provide updates. The box contains a list of items, each composed of text and an optional icon. The Profile Box API allows you to manage the items in your app’s profile box. The API reference for this new API is here.

One final item that you should be aware of is how popup windows are handled. With this release, the popup blocker is disabled by default.  This means that popups will display in the Child Browser window.  If you wish to enable the popup blocker functionality there is a new parameter that you can pass in config.xml to the “blackberry.app” feature.  For information, see the <param> element.

<feature id="blackberry.app">
  <param name="popupBlocker" value="enable" />
</feature>

Be sure to download the latest SDK, and check out the Payment service to see how you can develop a richer monetization strategy for your application.

Hey #TeamBlackBerry, if you were up at the wee hours of the morning today, you may have noticed a change to the BlackBerry App World web store. It is now simply called BlackBerry World. The naming change reflects a shift in the type of things you can purchase from the store as we transition to BlackBerry 10 and beyond.

As we mentioned back at BlackBerry Jam Americas, BlackBerry World will have much more than just apps – it will now be home to Videos and Music as well. BlackBerry World is going to be the one-stop shop for all of your mobile entertainment needs.

With BlackBerry World, there are various ways to browse, download, buy, and manage apps using a BlackBerry smartphone, BlackBerry PlayBook tablet, or desktop or laptop computer,— inspiration is at your fingertips. And if you find something you love and want to tell the world, you can easily share it with your friends over BBM, Facebook and Twitter. Also, you can simply tap smartphones together and invite your friends to download it — just like that.

The change will happen on the web storefront first and will be rolled out to the BlackBerry PlayBook tablet and BlackBerry smartphones in the coming weeks. If you’re asking, “what about the BlackBerry World conference?” – we’ll have more details on that for you soon!

NOTE: Please be aware it may take up to 24 hours for the changes to appear.

Have a blog? Facebook page? YouTube Channel?

Great news: you can convert it into a BB10, PlayBook or BBOS App in less than 10 minutes, using BlackBerry App Generator. Watch this short video and learn how:

Step 1: Sign up for a BlackBerry App World Vendor Account: https://appworld.blackberry.com/isvportal

Step 2: Create your App using BlackBerry App Generator: http://www.blackberryappgenerator.com/

Step 3: Publish to App World.

Yes, that easy! Piece of cake! Good luck everyone.

In order to be eligible for a Limited Edition BlackBerry 10 smartphone, you must have received a BlackBerry 10 Dev Alpha testing device, submit a qualifying app, and you must also qualify under the program terms and conditions. Once you’ve submitted your app and it qualifies, you will receive an email indicating you qualify and instructions on how to trade in your BlackBerry 10 Dev Alpha testing device.

Here are the answers to some of the most common questions we’ve been receiving.

• When do I have send in my Dev Alpha?
  • The Dev Alpha device can be returned anytime. Please keep in mind that the Limited Edition devices will not begin shipping until six to eight weeks after the BlackBerry 10 launch on January 30, 2013.
  • You will not receive a Limited Edition device until you return the BlackBerry 10 Dev Alpha testing device.
• When will I receive my Limited Edition device?
  • The Limited Edition devices will begin shipping out six to eight weeks after the BlackBerry 10 launch on January 30, 2013
• Can I still register for a Limited Edition after January 21, 2013?
  • Yes, the January 21, 2013 deadline is for submitting your application in to BlackBerry World. The registration for Limited Edition can be completed anytime, using the App ID of an app submitted by January 21, 2013.
• Why have I not received an email yet?
  • This is likely because your submission is still in the queue to be validated against the terms and conditions. Once tested, you will receive an email with your qualification status.

If you have more questions, please view the Limited Edition FAQ.

Car Polish / JMR_Photography / CC BY 2.0

Last month we delivered the Gold release of the BlackBerry 10 WebWorks SDK to our development community. This was a huge milestone on the road to launch for BlackBerry 10, allowing our developers to confidently develop, test, and submit their WebWorks applications to BlackBerry World, and to take part in the Built for BlackBerry program. I am sure all of you have already submitted your apps and are now relaxing by the pool.

Today we are launching a refresh to the WebWorks SDK that brings a number of fixes that, while not required for your application to run on BlackBerry 10, bring a few tweaks and stability improvements. There are two very specific updates addressing some underlying platform changes that COULD mean you will want to repackage an existing application. Let’s look at those first.

The concept of Cards in BlackBerry 10 is what really enables the Peek and Flow experience. There are many built-in cards that developers are able to leverage to complete common tasks or integrate with system services, and WebWorks has provided built-in APIs for some of these system cards. One of them is the File picker (blackberry.invoke.card.invokeFilePicker). In the gold release, you could provide a list of directories in the FilePickerOptions object, and the standard UI would present a selection list of those folders. This ability was removed from the standard UI. The API has not changed, but we only now look at and use the first entry in the array to seed the UI. So as long as you were not relying on this multi-directory functionality, or if you don’t mind that only the first is considered, then you have no need to repackage your application.

Another update relates to how Contacts are created, or more specifically, what happens when you save a newly created contact using the blackberry.pim.contacts API. In the Gold SDK, when you save a contact that you create using blackberry.pim.contacts.create(), it will always create a new entry in the device address book. The underlying native implementation changed slightly and will now attempt to merge it with an existing relevant contact entry if it finds one. If you are fine with this behavior, or if it is desirable, then you need to do nothing if you have already packaged with the Gold SDK. Otherwise, in order to preserve the behavior of creating a new contact, you will need to repackage with this latest WebWorks SDK refresh.

That’s it for compatibility concerns – not so bad. There is one other thing though that you will notice with the latest Dev Alpha update. If you are using the blackberry.invoke.card.invokeEmailComposer API, clicking the Send button actually does nothing. This has already been fixed on the native platform and will work at launch. You have no need to repackage your app, either now or later, as the fix is entirely on the device, but just something to be aware of if you use this API and are testing it on the latest Dev Alpha build.

Finally, let’s turn to a couple of the polish items that we have in this refresh. As most of you are probably aware, BlackBerry Balance allows the user to segment their device into multiple perimeters to separate work and personal. The enterprise perimeter can be locked if a password is enabled, and when locked, apps are “locked” as well. In order for you as the developer to know what the current state is, we have introduced events that you can listen for that will tell you when the perimeter locks while your application is open. Check out blackberry.system.perimeterlocked/perimeterunlocked.

We have also expanded the Contacts API to include the Accounts information for that contact. Check out the new field blackberry.pim.contacts.contact.sourceAccounts.

We recently added the ChildBrowser concept to WebWorks that allows you to support target=”_blank” and window.open in your web content. We also allowed you to disable it. With this release, if you disable the ChildBrowser and use target=”_blank” or window.open to display non-whitelisted content, the result will be opened in the system browser, rather than the user being presented with an access denied dialog.

Context menus and custom contexts have also seen a couple of improvements. When you add your own menu item to the context menu, the callback that is invoked when the menu item is clicked will be passed the id of the content element that the user long-pressed on. You can also now override existing menu items through the blackberry.ui.contextmenu.additem method. Just provide the platform action id in the additem call and you can provide your own text, image, and functionality for things like Copy, paste, and so on.

As you can see, unless you use one or two specific items, applications you have already packaged and built are still good to go. But if you do use the contacts API and wish to always create new items as oppose to merge, or if you used the file picker in a specific mode, you will want to repackage and resubmit your applications to BlackBerry World. And be sure to get your applications approved for sale prior to January 21st, and take advantage of the Built for BlackBerry program. Download the gold refresh of WebWorks today to polish up your applications before launch of BlackBerry 10!

DSC04801 / mat79 / CC BY 2.0

Months of planning. More months of development. Re-planning. Long hours. Trips around the world. Meeting with you, our BlackBerry WebWorks development community. It all culminates with this: the gold release of the BlackBerry 10 WebWorks SDK. The team here could not be more stoked to deliver this final developer milestone on the road to the launch of BlackBerry 10. I apologize for the use of the word “stoked” in the preceding sentence, but I could not help myself. We are REALLY excited.

We recently delivered the final Beta of the BlackBerry WebWorks SDK in conjunction with our recent BlackBerry Jam Asia conference. With that release we began guaranteeing compatibility of your applications, which was a major milestone. Hopefully you have already started submitting your apps to BlackBerry World for approval and preparing your application to the Built for BlackBerry program.

Of course, the team has continued to work days – and many nights – to ensure this gold release is rock solid. Of course, we also snuck a few new things in.

We now have a full house of cards that you can directly invoke from webworks. From the blackberry.invoke.card namespace, you can leverage the following new cards on top of the camera and file picker cards we already delivered: calendar picker, calendar composer, email composer, media player, contact picker, and ICS viewer card.

We have also now provided to you the means to leverage the built in invocation selection UI. If you choose to do your own invocation target queries and provide the user with the ability to select the target, you can use the API to present native look and feel selection UI.

Wallpaper: an interior decoration technique that has happily fallen out of favour (opinions my own and do not reflect those of my employer). But smartphone users love setting the wallpaper of their device. Allow the user to set the wallpaper from your BlackBerry WebWorks app:

blackberry.system.setWallpaper(pathToImage);

You can now also specify custom contexts in your applications that can be used as a target type for invocation request, and to put custom actions into the context menu.

<div align="left" data-webworks-context="myContext">>

   <h4>Local image link: with customContext</h4>
   <a href="http://www.blackberry.com">
      <img src="../../img/secretdeviceimage.jpg" width="150" height="350"/>
   </a>

</div>

If the user triggers an invocation – say, as a long-press on any element within the div in the code example above – the system will pass the “myContext” custom context in the invocation request rather than an image context.

In addition, you will often want the ability to know when your context has been the target of a user-triggered invocation, and do something before the system completes the invocation. In the example above, you might want to add to the invocation request additional relevant information for the “super secret device”. All you need to do is assign a function to the blackberry.invoke.interrupter property. This function will be given the invocation request object, and you can return a modified version of the object that will actually be sent on in the invocation request. You may also just want to allow the user to confirm they wish to take this action.

blackberry.invoke.interrupter = function (request) {          
	if(confirm("System would like to invoke: " + request + " would you like to continue?")) {
              return request;
        } else {
              alert("User canceled invocation");
        }
};

One of the key user experience items for BlackBerry 10 is the concept of Active Frames. When your application is no longer in the foreground but still running, it gets a placeholder window that by default displays a snapshot of the application when the user put it into the background. With this API, you can customize what is displayed. You can set a different image, as well as specify custom text that will be overlaid onto the image. If you wish, you can also periodically update the cover, or reset it to the snapshot originally taken by the system. Check out the documentation for more info.

function onEnterCover() {
    blackberry.ui.cover.setContent( blackberry.ui.TYPE_IMAGE,
        {path: "/path/to/an/image/windowCover.png"} );
    blackberry.ui.cover.labels.push({label: "Label 1",
                                 size: 15,
                                 wrap: false});
    blackberry.ui.cover.setTransition(blackberry.ui.cover.TRANSITION_FADE);
    blackberry.ui.cover.updateCover();
}

blackberry.event.addEventListener("entercover", onEnterCover);

Even though this is the gold release, we know there are a few things still missing that we are working hard to deliver. The nice thing about BlackBerry WebWorks is that we can expose existing native platform functionality outside of device OS and native SDK updates. Keep an eye on the flight boards as we are actively planning maintenance releases to deliver a few more things.

But the gold release is your cue to finish your BlackBerry WebWorks application so that you can leverage the first-mover advantage. Get out in front of the wave and be one of the first applications in BlackBerry World. And be sure to get your applications approved for sale prior to January 21st, and take advantage of the Built for BlackBerry program. Download the gold release of BlackBerry WebWorks and put that final luster on your applications!

Well, it’s easy. Prior to January 21st, 2013 (the cut-off date for the 10k Developer Commitment), log in to your vendor account in BlackBerry World. Then, click the Manage Products link. Your screen should look something like this:

The first thing to take notice is the Status of your application. Before you can apply for Built For BlackBerry, the status must be Approved or Up For Sale. If your application has not been approved for BlackBerry World, you cannot submit it to Built For BlackBerry testing. If the status is approved, you will see the word Apply underneath the heading “Built For BlackBerry”. Go ahead, click that link.

Here is where you agree to the terms and conditions of the two programs. If you are only interested in the Built For BlackBerry Program, you only need read and agree to those terms. This means your application or game will go through Built For BlackBerry testing but will not be eligible for the 10k Developer Commitment. If you want to be part of the 10k Developer Commitment, then you must read and agree to both terms and conditions. Once you have read and agreed to the terms, check the boxes next to the appropriate terms and conditions and click Save.

Your Manage Product screen will be updated to show you have applied for the program and your application is Pending approval.

Once your application or game has passed the Built For BlackBerry testing, the term Pending will change to Approved. But what if something is amiss? What if your application or game is Rejected?

Don’t panic – you’ll see that there is a message icon next to the term Rejected. Clicking this message icon will show you the reason(s) why your application failed the Built For BlackBerry testing. You can fix those issues in your application and resubmit the application for Built For BlackBerry testing.

That’s really all there is to it! Built For BlackBerry will identify your application as a great BlackBerry 10 application. I am really excited to start seeing, using, and playing all the Built For BlackBerry applications and games. Remember, launch is January 30th 2013, so make sure you get your apps into Built For BlackBerry testing before January 21st, 2013.

As we promised a few weeks ago, a BlackBerry® WebWorks™ SDK would be released soon that would have compatibility of applications moving forward. That day has arrived with the latest update to the BlackBerry 10 WebWorks SDK! Applications that are built with this BlackBerry WebWorks SDK will run on the latest delivered BlackBerry® 10 OS beta version as well as future OS updates.

Note that this does not mean that APIs don’t have the potential to change in the future, and there will certainly be more APIs added – but an application binary compiled with this SDK will continue to run on future OSes. With this guarantee, you can now build your BlackBerry WebWorks applications and submit them to the BlackBerry App World™ storefront for approval. You can now also apply for the Built For BlackBerry program before January 21st 2013 to take advantage of our 10k Developer Commitment to developers.

However, no BlackBerry WebWorks release would be complete without some new API additions. We have a ton of great stuff so let’s dive in.

Perhaps our biggest addition is the ability to integrate with the Calendar on the device. Create, edit, delete – it’s all there. It also delivers access to all calendars available on the device while of course respecting the work/personal boundary provided by BlackBerry Balance™. Combine this with the Contacts API delivered in the previous release for some very compelling applications that integrate with the BlackBerry 10 integrated PIM story.

Everyone likes toast (well, they should), and BlackBerry 10 has brought a mobile flavor to this breakfast staple with the Toasts notification concept. Toasts are quick, non-blocking notifications to the user that your application has performed some action, which are displayed for a minimal amount of time and then disappear. You can also enhance your toast with butter a button that allows the user to take some action in relation to that toast (eg. a toast that notifies the user that an item was deleted, and provides an Undo action). Check out blackberry.ui.toast for more on this one.

blackberry.ui.toast.show(“Pass the jam!”, options);

Now, wouldn’t it be cool if you could have a sensor in your phone that would tell you that your toast is ready before it was burnt? Well, no, we can’t do that (yet). But with this release of BlackBerry WebWorks, you now have access to a whole host of new sensor APIs. Orientation, light, proximity, compass, space-time disturbances; okay, not space-time, but yes on the rest. Leverage these APIs to add some real value into your application based on the device environment.

// Create a callback to handle each sensor function compassCallback(sensor, data) {
     alert("Current azimuth: " + data.value); }

// Start listening to the compass sensor with a delay feedback of 1000  blackberry.sensors.setOptions("devicecompass", { delay : 1000 });

// Start the event listener for the sensors callback blackberry.event.addEventListener("devicecompass", compassCallback);

In the previous release of BlackBerry WebWorks, we provided a way to lock the orientation of your application by setting a flag in the config.xml. We have now provided a full JavaScript® API that allows you to lock/unlock your application dynamically based on your own logic. There are a few things to note with this change: To have a good JavaScript API signature, we are putting the orientation functionality right on the blackberry.app namespace, but this is out of line with the current config.xml approach of putting the parameter on the blackberry.app.orientation feature. So we have deprecated this, and now you should put orientation in config.xml on the blackberry.app feature. Also, if you do choose to set it in config.xml, that is a constant value that cannot be overwritten by the API – what you set in config.xml is what you get.

Speaking of config.xml, with this release we have all the pieces in place to allow for full localization of your application, including the display name of your application as well as the description. In the config.xml, you just need to put the localized text inside another element with the xml:lang attribute for the language. Furthermore, all of the built-in UI components are fully localized and reflect the current system language.

<widget xmlns="http://www.w3.org/ns/widgets">
<name>
    The Ultimate Weather Widget
</name>
<name xml:lang="fr">
     insérez Françaises ici
</name>
</widget>

Let’s now take a look at some enhancements made to the underlying BlackBerry WebWorks platform. With this release, we have delivered a number of different optimizations to the runtime initialization process. Lots of highly technical, egghead type stuff. Long story short – your apps should load a whole bunch faster for your end users. Be sure to get the latest BlackBerry 10 OS build to see the full benefit.

Perhaps even more interesting is the addition of a child web view control. If you have a link in your content with target=”_blank” or use the window.open function, the content will now be loaded in a child web view that looks much like a card and won’t overwrite your current content. The user can then cancel the view to return to the originating page. When you use window.open, you will receive a window object for the child web view. One of the more obvious use cases here is a more seamless method of supporting OAuth for authentication into social networks like Facebook®, foursquare, Twitter®, and so on.

We have also added a new attribute to the element in config.xml that allows you to specify a single HTTP header key-value pair. This HTTP header will be added to every HTTP request sent from your application. This allows your backend system to key off of this header and perform any required customized processing for your app.

<widget rim:header=”header:Goooallll!”>

If that wasn’t enough on its own, we have also added a few new tooling features that should make your life a lot easier. First on deck is the ability to pass your application’s root folder into the bbwp tool to package your application. No more requirement to first zip your application content and risk feeling silly when you forget to update your zip file with your latest changes. The packager also supports ignoring folders and files within your application folder hierarchy; just create a “.bbwpignore” file in the root folder and list the folders and files you don’t want to be part of your application packager. The format of this file is essentially the same as the .gitignore file, with one or two very small differences.

Another potential time saver and headache reliever is a new facility that will allow you to forget about ever needing to update the version of the webworks.js file you reference in your app. In your application files, reference the webworks.js file like so:

<script src=”local:///chrome/webworks.js”>

The packager tool will include the latest webworks.js into your package and put it at the appropriate location to be loaded.

So there you have it. It is worth reiterating that with this release you can now submit your apps to BlackBerry App World and be assured they will run properly come launch of BlackBerry 10! So submit early so you can get your application approved, and then apply for the Built For BlackBerry program before January 21st, 2013. No time to waste – grab the SDK today!

As a thank-you to the BlackBerry® 10 Dev Alpha community, we are offering you the opportunity to trade in your BlackBerry 10 Dev Alpha testing device for a new Limited Edition BlackBerry 10 smartphone!

In order to be eligible for a Limited Edition device, you must qualify under the terms and conditions, and you must also have received a BlackBerry 10 Dev Alpha testing device.

1. Submit a qualifying BlackBerry 10 app
2. We will send you a note indicating you qualify and instructions on how trade in your BlackBerry 10 Dev Alpha
3. Complete step 2; a follow-up email will be sent after the BlackBerry 10 launch event on January 30th, 2013

Your BlackBerry 10 application(s) need to be created and submitted to BlackBerry World by January 21, 2013. The application will go through testing and will be deemed either qualified or not qualified based on the terms and conditions.

Want to know more? Check out developer.blackberry.com/limitededition

As you know, there are BlackBerry 10 smartphones coming in Q1 2013 – an all-touch model similar to the BlackBerry 10 Dev Alpha, and a BlackBerry 10 smartphone with our industry-defining BlackBerry QWERTY keyboard.
Today we announced the next phase of the BlackBerry 10 Dev Alpha program – the BlackBerry Dev Alpha C. It is a testing device for developers so that you can adjust, debug, and test your BlackBerry 10 applications to get ready for the launch of the BlackBerry 10 QWERTY device next year.

We’re only producing a limited number of these testing devices, and they will be reserved on a priority list for developers who have demonstrated that they are building apps for BlackBerry 10.

Distribution will be limited to developers who submit two or more applications; these developers will be given priority seeding for the BlackBerry 10 Dev Alpha C. These developers will be determined on the following point system:

• 50 points for ported Android™ applications
• 250 points for all other applications (Native, BlackBerry® WebWorks™, Adobe® AIR®)
• 1500 points for Built For BlackBerry certified application
• BlackBerry 10 Dev Alpha A/B recipients start with 200 points
• BlackBerry Elite Members start with 200 points

The BlackBerry 10 Dev Alpha C offer will run from December 1, 2012 through February 5, 2013. The details on the program can be found here, and keep following @BlackBerryDev for more info.