Simon Mac Donald

Books I've Read This Week

noreply@blogger.com (Simon Mac Donald) — Fri, 27 Jan 2012 14:49:00 +0000

Reality Is Broken by Jane McGonigal reminded me of an idea I was toying with implementing back when I was a software development manager. Back in those days no one liked doing their yearly review as it truly was a pain in the ass to keep track of your yearly achievements and it really didn't amount to anything as pay cuts and not raises were the order of the day. I wanted to implement an experience points system for my developers. For each bug they fixed, test case they wrote or document they reviewed they would get experience points. Then at the end of the year they would have a good record of what they had done and a quantitative number to compare against last years performance. Ideally the developers would get more points for the less desirable tasks. For instance fixing a bug would be worth less points than writing a test case. I hoped that it would incent people to pay more attention to some of the things we are no are important but are often ignored in software development. Alas, it was not to be.

As a gamer and software developer I really identified with the tenants of this book. I'm supremely lucky to have a job in which the motivations for me to come to work every day are more intrinsic than extrinsic and at this point I can't ever imagine going back. During the day I tend to answer a lot of questions about PhoneGap on the Google Group or on StackOverflow. I get more satisfaction from StackOverflow as it provides me feedback on my answers. They are up voted and accepted by other users of StackOverflow. This feedback I get from other users gives me intrinsic motivation to keep going.

The notion of using gaming to enhance and improve reality is fascinating one and very well articulated in this book. I will have to agree that collaboration is going to be one of the key skills of the 21st century. Without collaboration we will be unable to get past the challenges we currently face.

Here is a great Ted talk by Jane McGonigal that may whet your appetite for this most excellent book:

Hellboy Volume 11: The Bride of Hell and Others is another good volume from Mike Mignola in the Hellboy ouvre. While it does not exactly move the story forward that we've seen back in Hellboy volume 9 it is a good collection of Hellboy stories and is worth reading for Hellboy and the Luchador's!

See you next Friday.

There's Nothing Like a Real Book

noreply@blogger.com (Simon Mac Donald) — Tue, 24 Jan 2012 18:44:00 +0000

Books I've Read This Week

noreply@blogger.com (Simon Mac Donald) — Fri, 20 Jan 2012 15:30:00 +0000

Steve Jobs by Walter Isaacson in a word is mesmerizing. This is a great no holds barred biography of a complicated man. Jobs was such a polarizing figure as many folks loved him while other absolutely detested him. Although the one thing you can't argue with is that he had a huge impact on technology. Jobs was the driving force behind Apple who've given us the Macintosh, iMac, iPod, iPhone, iPad which revolutionized the computer, music and phone industries. As well he was deeply involved in Pixar which has brought us some of the best movies of the past 20 years. That's not to say that he hadn't made a number of mis-steps along the way, NeXT for instance.

To Jobs things we either insanely great or shit. There was no in between for him as his opinions were of a binary nature. He was extremely hard to deal with and the book gives us an unvarnished view of his relationships with friends, family and business partners.

This is one of those books released in 2011 that is a must read.

See you next Friday.

Books I've Read This Week

noreply@blogger.com (Simon Mac Donald) — Fri, 13 Jan 2012 19:27:00 +0000

Keeping in line with my new years resolutions my books have taken a turn towards non-fiction

Psychopath Test by Jon Ronson is a very interesting book the details how to detect psychopath's by answering a 20 question test. As the author mentions in the book once you start detecting psychopaths you'll start seeing them everywhere which is a bit of a problems. However, it is a great insight into how some folks brains are wired incredibly different than the average.

Great By Choice: Uncertainty, Chaos, and Luck--Why Some Thrive Despite Them All is the latest in a series of books by Jim Collins. In it Collins examines a number of companies to determine what specific choices they've made in order to become great. Some of the qualities that emerged were the great companies didn't take crazy risks, first they tested their assumptions a little at a time before deciding to jump in with both feet and when things are going well that is the time where the great companies get extremely paranoid about how it could all go wrong.

See you next Friday.

Book Review: PhoneGap Beginner's Guide

noreply@blogger.com (Simon Mac Donald) — Wed, 11 Jan 2012 20:59:00 +0000

Phonegap Beginner's Guide by Andrew Lunny delivers exactly what the title promises as it is a good guide to developers just getting started with PhoneGap. The book walks you through the installation of the PhoneGap framework, shows you how to develop and debug your application in a web browser before bringing it over to the device and describes a number of HTML5/CSS3 features you can take advantage of without even needing PhoneGap. Then the book walks you through a number of areas of device functionality that the PhoneGap API like the accelerometer, camera and contacts. Plus there is a chapter devoted to extending PhoneGap functionality using the Plugin API.

The only con that I can point out is that the book does not completely describe the available PhoneGap API, nor should it really as it is targeted at beginners. I can't fault Andrew at all as a lot of the currently functionality was delivered after the books was sent to be published. One thing you should be aware of is that chapter 9 describes the navigator.service.contacts interface which is now navigator.contacts.

I do recommend this book for PhoneGap and fledgling hybrid mobile application developers. Probably the easiest way to get it is as an ebook from Packt.

Books I've Read This Week

noreply@blogger.com (Simon Mac Donald) — Fri, 06 Jan 2012 17:33:00 +0000

I had to return The Children of the Sky back to the library but here are some other books I read.

For the Love of Physics is a great read that explains physics in laymen's terms by Professor Walter Lewin. It is well worth the read if only for the chapter in which he explains rainbows and how to spot the easier. As an added bonus you can get all of Professor Lewin's entertaining lectures on physics courtesy of MIT's open course ware.

Scalped Vol. 1: Indian Country by Jason Aaron is a series I've been meaning to check out for awhile. Set in a fictional Indian reservation undercover FBI agent Bad Horse returns home to take on a corrupt reservation chief and casino owner while dealing with his activist Mom and ex-girlfriend. It sounds very soap operaish but this was a great crime comic.

Kamandi Last Boy on Earth Omnibus Vol 1 by Jack "The King" Kirby is pretty amazing. Published during a time where the Planet of the Apes movies were hot properties the similarities are obvious. Kamandi is the last reasoning member of the human race. After his grandfather dies his leaves the bunker he's lived his whole life to explorer the world where he encounters Lions, Tigers, Apes, etc. that have evolved to become the dominant species on earth while humans have regressed to near unthinking animals.

Each and every one of the 20 issues in this omnibus is just bursting with ideas. There is so much going on in these pages that it is too hard to get it all into one blog post. At the end of the first issue there is a map of North America so you can see Kirby had a plan for where he wanted to take this series. Also, while this comic was being published Jack Kirby was doing two other monthly books so he was producing upwards of 60 pencilled pages of art. These days, it's hard enough to get an artist to do 20 pages a month consistently. The pure draftmanship of this book is outstanding.

See you next Friday.

My New Year's Resolutions

noreply@blogger.com (Simon Mac Donald) — Fri, 06 Jan 2012 15:57:00 +0000

It's about a week after new years and I've been thinking a lot about this years resolutions as I'm going to take them seriously this year. Some of them might seem pretty odd if you just read the titles. Honestly, this isn't a post for you blog readers it's much more for myself. I figure if I put it out there people will call me on it and I'll be more likely to keep my resolutions.

Read Less

Last year, according to my Shelfari account, I read 218 books. Breaking them down into genre looks like this:

The pie is dominated 68.7% by Comics and Manga. Predominantly that was taken up by some epic runs of manga like Monster, 20th Century Boys, Naruto and One Piece and graphic novels like Preacher, B.P.R.D. and Fables.

This upcoming year I'm going to read less books and change my focus to Technical and Non-Fiction books. I have a lot of eBooks I've bought from O'Reilly's Deal of the Day that are just begging to be read. I'm targeting that come the end of 2012 the technical and non-fiction portions of this pie will be about 50%.

It's not that I don't enjoy comics/manga I just need to concentrate on some different things this year.

Exterminate, Exterminate, Exterminate

With Dalek like dispassion I'm going to remove a lot of stuff from my life. The first thing I'm going to do is look at the information overload. I currently subscribe to 106 RSS feeds in Google Reader, follow 308 people on Twitter, subscribe to 38 podcasts and get an enumerable amount of emails a day. I'm going to be absolutely brutal about killing feeds, un-following, deleting podcasts and unsubscribing from email lists until I can reduce the incoming information by a minimum of 25%.

At home I'm going to get rid of a number of books, DVD's and comics that are frankly just collecting dust. There is just too much of my junk cluttering up the house and especially my office. I'd love to hear what suggestions people have for old books and comics. Right now I'm thinking about making a rather sizeable donation of used books to the amazing Ottawa Public Library and a bunch of comics to CHEO.

The extermination will not spill over into other time wasters in my life. I'm going to cut back on my TV viewing. It's not that I watch a lot of TV but I want to shift those hours spending more time reading or creating. I've already got a PVR I built myself using BeyondTV at home to that saves from commercials and appointment viewing but a few shows may not make the cut in 2012. Nathan Fillion I love you but Castle hasn't really been that good this season with the introduction of Captain Victoria Gates. That character has been poison to the show. Also, How I Met Your Mother would benefit a lot by phasing out Ted as a character. Maybe he can architect a building in Dubai or something.

The Obligatory "Get in Shape" Goal

It's not that I'm in bad shape. I play ice hockey twice a week and I'm pretty fit for a man of my advancing years. However, I could stand to lose a few pounds. I'm a bit scared that I'm developing that skinny fat guy disease. I don't think I'll ever get back to the days where I'm doing a couple of triathlons a year but I'm going to make the commitment to fitness this year one of my top priorities. To that end, the opening of the new gym in my building can't come soon enough.

One thing that I know will make a big dent is:

NO. MORE. SODA.

I've gotten back into the bad habit of drinking soda pop with meals. I blame Christmas and having the devils drink at home for people who were visiting. Unfortunately, I started drinking it again at home and then while out of the house but no more!

Look forty, I'm going to be ready for you. If you plan on hitting me hard in a couple of years I will be ready to hit back.

Publish or Perish

Recently Dean Haspiel published an article called Publish or Perish that was inspired by a tweet from comic book writer Jimmy Palmiotti. Basically Dean posits that freelancers now have the all the tools they need to publish their own work or get run out of the business. The post deals with comic book professionals it is all very germain to software developers.

While I'm not going to do anything to jeopardize my incredible day job that allows me to work on PhoneGap on a daily basis I am going to do some things that stretch the bounds of my current role.

I will publish my first application to the Android Marketplace. It will be for free and it will be open source. Beyond that I have a few other ideas for applications but at a minimum I will get this first app out early in 2012. It may not help anyone else but it will fix a problem for me.

I will write my first book. It may never get published but I will write it. Wait scratch that, it will get published as there are a couple of publishers who have expressed interest and if they don't want to release it I will self publish it. There I said it, I'm doing it.

Obviously, it will be a technical book. I don't think the world is ready for my take on Batman but hey DC Comics if you want to hear my pitch just let me know.

On the Twelfth Day of PhoneGapping: User Contributions

noreply@blogger.com (Simon Mac Donald) — Thu, 05 Jan 2012 20:25:00 +0000

Did you know if there is a missing bit of functionality in PhoneGap you don't need to wait for the core development team to get around to it? You can take matters into your own hands since PhoneGap is an open source project.

Let's say you have a bit of functionality that is only required on one platform, well the best thing to do in that case is to write a plugin. If you want to share your plugin with the world then let us know by submitting a pull request on the PhoneGap Plugins repository. Submitting to this repository only requires for you to have a GitHub account. There is no need to sign any contributor license agreement. We love to get new plugins.

However, let's say you've identified an area of the API that is lacking. Until PhoneGap 1.3.0 there was no download function for the FileTransfer class. Well developer Alexander Heinrich decided to fill that niche by submitting pull requests that added the functionality to iOS and Android. That was a huge help and the BB developers were able to step in an fill in the functionality in their repository. Up until that point Alexander was not a member of the core PhoneGap developers but after he signed the Apache ICLA and we reviewed his code he was in. It's as simple as that.

So to all of you my challenge is for you to be the next Alexander Heinrich! Create a plugin, fix a bug add new functionality.

On the Eleventh Day of PhoneGapping: Configuration Defaults

noreply@blogger.com (Simon Mac Donald) — Wed, 04 Jan 2012 22:04:00 +0000

As much as we'd like to make PhoneGap 100% cross platform there are some differences between platforms that sometimes need to be smoothed over. Two items that I can think of off the top of my head are:

1) Android's persistent file system defaults to the SD Card which everyone can read from while in iOS it defaults to a directory that only the app can read.

2) In order to play a Media file the path to a file in the www directory is different for Android and iOS.

So to smooth these difference over you can create a .json file that is included in your www directory which will hold platform specific configuration details and load it via XHR. Here's how to do it:

Your .json file on Android could look like:

{

"mediaPath": "/android_asset/www/"

}

and on iOS it would look like;

{

"mediaPath": ""

}

So now you can replace clunky if statements like:

if (device.platform == "Android") {
    var my_media = new Media("/android_asset/www/test.mp3");
} else {
    var my_media = new Media("test.mp3");
}

with:

var my_media = new Media(Config.mediaPath + "test.mp3");

and continue to access everything in a cross platform way.

On the Tenth Day of PhoneGapping: Searching Contacts

noreply@blogger.com (Simon Mac Donald) — Tue, 03 Jan 2012 19:41:00 +0000

As I've mentioned before some of the W3C specifications that we base the PhoneGap API on are the difficult to understand. The Contacts API is definetly one of the hard to understand ones. Here is an example of searching the phones contacts and handling the gotchas that may arrise.

First here is the method signature used when searching contacts:

navigator.contacts.find(
    contactFields, 
    contactSuccess, 
    contactError, 
    contactFindOptions);

contactFields [Required]: is an array of strings that represent the fields from the Contact object you want returned as part of the search results. For example if you wanted to get the contacts display name and email addresses you would specify:

["displayName", "emails"]

if you would like to get each an every field populated in the returned array of Contacts you would specify, what I call, the fire hose option.

["*"]

However, be careful not to specify too many un-needed properties in the contactFields array. The array does double duty in the find command as the filter you specify in contactFindOptions is applied against each and every field in the contactFields array but we'll talk about that more later.

contactSuccess [Required]: is the success callback which is invoked with an array of contacts.

contactError [Optional]: an optional error callback which is invoked if something goes wrong with the find command. The only parameter to the function is a ContactError object.

contactFindOptions [Optional]: is an optional ContactFindOptions object which controls a couple of options in the find command. The two parameters in the contactFindOptions are

filter: specify what you want to match against.
multiple: set to true if you want more than one contact returned in the success callback.

by default filter is set to the wildcard (match everything) and multiple is set to true.

Find Examples

1) Find all the names and email addresses of contacts with Ottawa area phone numbers.

navigator.contacts.find(
    ["displayName", "name", "emails", "phoneNumbers"], 
    contactSuccess, 
    contactError, 
    {filter: "613", multiple: true});

2) Get all the contacts on the device.

navigator.contacts.find(
    ["*"], 
    contactSuccess, 
    contactError);

3) Find all contacts named "Bob" and where they work.

navigator.contacts.find(
    ["displayName", "name", "organizations"], 
    contactSuccess, 
    contactError, 
    {filter: "Bob", multiple: true});

Gotcha's

1) Slow search results.

As I mentioned earlier the more items you specify in contactFields the longer your search will take as the filter will have to be applied against it to see if the contact matches the filter. Please try and limit the contactFields array to only the parameters that you absolutely need.

2) Null values

Frequently people end up running into errors in their success callbacks as they don't guard against null values properly. According to the W3C spec if there are no results for array values like emails, phoneNumbers, addresses, etc. the code should return a null for theses values and not an empty array. So when folks try to loop through all the returned emails it will error out as you can't access the fields of a null value. So when you try to access one of these values guard agains the null.

if (contacts[i].phoneNumbers != null) {
    for (j=0; j < contacts[i].phonenumbers.length; j++) {
        // Do stuff
    }
}

23 1/2 Hours a day

noreply@blogger.com (Simon Mac Donald) — Tue, 03 Jan 2012 02:09:00 +0000

On the Ninth Day of PhoneGapping: Getting Help

noreply@blogger.com (Simon Mac Donald) — Mon, 02 Jan 2012 20:37:00 +0000

Besides being an excellent JavaScript toolkit PhoneGap is also a kick ass community of developers. The best place I know of to get help, and where I hang out answering a buch of questions is the PhoneGap Google Group. As well there is an IRC channel at irc.freenode.net, port 6667, with a room name of phonegap obviously.

In order to improve your chances of getting a quick and informative answer I'd suggest that you follow this process when asking a question on the Google group or on IRC.

First search the archives

Your question may have already been answered. Make sure you search at least PhoneGap Google group archives before you ask your question. Go to the PhoneGap Google group and use the search field in the top right of the page.

Provide details

Give as many details as possible. Incomplete questions won't likely be answered.

Include the following at a minimum:

what version number of PhoneGap are you using?
which platform and version you are testing on? iOS 4.0, Android 2.2, BlackBerry 6.0, etc.
a detailed description of your problem.
is this happening in the emulator only, phone only or both?

Select a concise, informative subject for the post. For example, include:

Platform, if issue is specific to Android, iOS, etc
Keyword examples: version, jar file, phonegap plugin, deviceready event, build
Short phrase summarizing the problem

You may also want to include:

some sample code that illustrates the problem.
logs taken while the problem was reproduced.

If the code or logs are huge, let's say over 20 lines please think about using a web service like Gist or Pastebin.com. Alternatively if you have a Dropbox account put the file in your public folder. Then share the link in the email rather than mailing around a bunch of large files.

An example of question

Wrong:
PhoneGap does not work for me!

Right:
I get a security error on PhoneGap 0.9.4 when I try to open a database using the Android 3.0 emulator. You can see the code I used here: https://gist.github.com/937307 and the logs I collected here: https://gist.github.com/937315. I have looked at the archives and the commits but did not find any solution. Does anyone know what could be the issue and whether this has been fixed?

An example of subject

Wrong:
Urgent. Need help with my problem.

Right:
Android / PhoneGap 1.2.0 : deviceready event not firing

On the Eight Day of PhoneGapping: Multiple Screen Sizes

noreply@blogger.com (Simon Mac Donald) — Sun, 01 Jan 2012 18:00:00 +0000

This is another question that comes up on the mailing list frequently, how do you support multiple screen sizes (portrait, landscape, phone, tablet)? Luckily there is a pretty good technique in web development that can be used in your PhoneGap application. It is called responsive web design and there is a book by Ethan Marcotte coincidentally called Responsive Web Design that I've recommended so often that I feel like I should be getting a kick back from the author (Full disclosure, I don't get a kick back). The book is only $9 and after you are done reading this post you should just go buy it.

In a nutshell, responsive web design uses CSS media queries to determine the width of your display and deliver different layouts based upon screen size. This would allow you to show a single column interface to portrait based phone users of your application but a multi-column approach to landscape table users. Let's run through a quick example.

For our phone users we'll setup our CSS so that our navigation sidebar shows up at the top and the main area of our application is underneath it. That would require some CSS that looks like this:

#wrapper {
            width: 90%;
            min-width: 0;
          }
          #main {
            margin-left: 0;
          }
          #sidebar {
            width: auto;
            float: none;
          }

We'll set our wrapper div to have a width of 90% because we don't want any text going right up against the screen as it make it hard to read. We'll give our main content a left margin of 0px so it is left justified against the wrapper div. For our sidebar we'll make the width auto so all the text will fit. So you app will look like this:

Now for the tablet version of the app you have a lot more screen real estate to work with so you want to have two columns. The left column will be the sidebar for navigation and the right column will be the main content area. Your CSS will look like:

#wrapper {
              width: 80%;
              margin: auto;
            }
            #main {
              margin-left: 40%;
            }
            #sidebar {
              width: 40%;
              float: left;
            }

The first thing you will notice in the CSS is that the wrapper div width is now 80% as we have more screen to work with so we can pad the sides a bit more. The main div is going to float over to 40% of the width of the wrapper div and the sidebar will be 40% of the wrapper div floating to the left side. And your app would look like this:

So that is all well and good but how does our app choose which version of the CSS to use depending on if it is running on a phone or tablet. Well that is the magic of CSS media queries. We'll wrap up our CSS with:

@media all and (max-width: 800px) { ... }

for the phone version of the CSS and:

@media all and (min-width: 801px) { ... }

for the tablet version. Simply screens up to 800px will get the phone version of the CSS and any screen over 800px wide will get the tablet version.

Here is a full HTML file for you to test out.

Interestingly enough for Android 3.2 and greater they've adopted a similar technique to responsive web design to handle multiple screen sizes on Android.

On the Seventh Day of PhoneGapping: Debugging

noreply@blogger.com (Simon Mac Donald) — Sat, 31 Dec 2011 17:00:00 +0000

One of the truly horrible things about doing web application development on mobile phones is the lack of web development tools that you'd see in modern desktop web browsers. Luckily for us a couple of folks have made it a lot easier to do web dev with tools like weinre by Patrick Mueller and iWebInspector by Maximiliano Firtman. I'm going to spend my time talking about weinre not because iWebInspector isn't as good but because I spend most of my time in Android land so I'm much more familiar with weinre.

The description from the home page:

"weinre is a debugger for web pages, like FireBug (for FireFox) and Web Inspector (for WebKit-based browsers), except it's designed to work remotely, and in particular, to allow you debug web pages on a mobile device such as a phone."

Isn't that great? You can have the developer tools you are used to back in your greedy little hands again.

The weinre home page has detailed instructions on how to setup your own server, which is not that difficult, but if you are like me (i.e. lazy) there is already a server setup for you at debug.phonegap.com where getting started is only three steps away.

On the Sixth Day of PhoneGapping: Downloading a File

noreply@blogger.com (Simon Mac Donald) — Fri, 30 Dec 2011 16:59:00 +0000

Did you know that the FileTransfer object got a new download method in PhoneGap 1.3.0? You didn't, well thanks to Alexander Heinrich for spurring it's development and getting it checked in for Android and iOS (download is also available to you BlackBerry users). Finally PhoneGap developers have a convenient way to download binary files.

The method signature is:

download(source, destination, successCallback, errorCallback);

Where the parameters are:

source: The URL you want to download
destination: The full file path you want the file stored at
successCallback: called with a FileEntry object that represents the new file
errorCallback: called when something goes wrong

So say we want to download a PNG image and store it on the SD card. Well you'd write some code that looks like this:

On the Fifth Day of PhoneGapping: Five Two Minute Tutorials

noreply@blogger.com (Simon Mac Donald) — Thu, 29 Dec 2011 17:00:00 +0000

Another re-blog but there are some gems here as the folks at Mobile Development Solutions have put together 5 two minute tutorials using PhoneGap Android.

They've put together tutorials on:

1) Media Player
2) Getting your app market ready
3) Barcode Scanning
4) Google Maps
5) Twitter and OAuth

Thanks to Libby and Paul for everything they do to support the PhoneGap community.

On the Fourth Day of PhoneGapping: Creating a Database from a SQL Dump

noreply@blogger.com (Simon Mac Donald) — Wed, 28 Dec 2011 17:00:00 +0000

On a slightly different track than Day 2 we are going to create a SQLiteDB from scratch using only JavaScript on startup of our application. In order to do this we are going to use the handy JavaScript library HTML5SQL.js by Ken Corbett Jr.

First we'll do a check to see if we've already created our database. If we haven't we'll do a XHR to get the SQL dump file containing all the statements we need to create and populate our tables. Finally, upon success we'll set a flag so this doesn't run every time we start our application.

and here is our sql file:

The html5sql.js lib makes working with the Web SQL specification much easier than hard coding it yourself. You owe it to yourself to look into this library as it will save you some time and hair.

On the Third Day of PhoneGapping: Getting Data from a Server

noreply@blogger.com (Simon Mac Donald) — Tue, 27 Dec 2011 17:00:00 +0000

Well your application would be pretty useless if you couldn't get data from a remote server now wouldn't it? Luckily since your PhoneGap application is running off of the file:// protocol it isn't limited by the same origin policy. This means we can request data using XmlHttpRequest from any domain.

I'm going to give you an example of searching for all tweets that mention PhoneGap that demonstrates this ability without the use of any extra JavaScript library like jQuery or Dojo.

So that is the example in a nutshell. It isn't very different from your normal XHR call except for one line that I need to bring to your attention:

if (request.status == 200 || request.status == 0) {

Most of the time you are just looking for the 200 status code you also need to accept the status code of 0 as also OK. Sometimes when you are requesting data via XHR from the file:// protocol you will get a 0 status code. As I said that is perfectly normal and you should treat it as a 200 and move on with your application.

Much of the rest of this code is just building up a HTML string I can do an insert into a div I've set aside for displaying the tweets. Just wanted to show everyone how easy it is to communicate with a remote server.

On the Second Day of PhoneGapping: Copying a native database

noreply@blogger.com (Simon Mac Donald) — Mon, 26 Dec 2011 17:00:00 +0000

The topic of creating a large SQLiteDB to persist data on the device comes up a lot on the Google Group. Sadly, most of the modern web browsers limit you to a maximum database size of 5 megabytes. If you really need a database bigger than that you'll need to jump through a few hoops.

Luckily a developer by the name of Gaurav S Tomar has already gone through the process of explaining how to do this in his excellent blog post:

Prepopulate SQLite DataBase in PhoneGap Application

So go check it out!

What you say? Here we are on the second day and he's already pointing us to other people's blog posts. Well I never said I was going to write the all just want to make you aware of some tricks you can use in your PhoneGap applications.

On the First Day of PhoneGapping: Get to deviceready faster on Android

noreply@blogger.com (Simon Mac Donald) — Sun, 25 Dec 2011 17:00:00 +0000

This tip is courtesy of a question that Pamela Fox posted up over on the PhoneGap Google Group as she was wondering why it sometimes takes longer for the PhoneGap deviceready event to fire.

As all good PhoneGappers know you need to wait until you receive the deviceready event before you can call any of the PhoneGap API's. But, what has to happen before the deviceready event fires? Well here is breakdown of events that fire before deviceready:

onDOMContentLoaded Internal event that is received when the web page is loaded and parsed.
window.onload Body onload event.
onNativeReady Internal event that indicates the PhoneGap native side is ready.
onPhoneGapInit Internal event that kicks off creation of all PhoneGap JavaScript objects (runs constructors).
onPhoneGapReady Internal event fired when all PhoneGap JavaScript objects have been created
onPhoneGapInfoReady Internal event fired when device properties are available
onPhoneGapConnectionReady Internal event fired when the connection property has been set.
onDeviceReady User event fired to indicate that PhoneGap is ready

That may seem like a lot but you don't have to worry about it as you can't speed up the process any. That is, except in one area. The onNativeReady event does not fire until the the onPageFinished method gets called on the Android WebViewClient.

So anything you do that increases the amount of time before the web view understands the page is completely loaded will keep you from getting to deviceready. For instance if you are doing a lot of things in the window.onload method it will delay deviceready. In Pamela's particular instance she was doing an XmlHttpRequest in the onload method which delayed things.

The fix and the tip in this case is to move as many things from your onload event handler to your deviceready event handler.

Books I've Read This Week

noreply@blogger.com (Simon Mac Donald) — Fri, 23 Dec 2011 19:08:00 +0000

I still haven't finished The Children of the Sky but here are some awfully short reviews to tie you over.

B.P.R.D. Volume 10: The Warning Liz is kidnapped and it is up to the team to track down the creepy guy who took her. In the background the teams main enemies get together and get organized.

B.P.R.D. Volume 11: The Black Goddess the team successfully tracks down Liz but will they be able to save her against the Frogs, the Black Flame and the remnants of Hyperborea. Plus, I'm really really beginning to hate Johann.

X-Factor, Vol. 1: The Longest Night by Peter David is a book I've been meaning to read for awhile now. I like this hard boiled detective story set in the Marvel Universe where the detectives are all mutants with super powers. I really enjoyed the first volume and I'm looking forward to the second.

See you next Friday.

Twelve Days of PhoneGapping!

noreply@blogger.com (Simon Mac Donald) — Fri, 23 Dec 2011 17:20:00 +0000

Starting on Christmas Day, December 25th, I'll be posting one PhoneGap tip per day for 12 days in what I'm grandiosely calling The Twelve Days of PhoneGap. Some of these tips you'll already know and some you won't but hopefully we'll all learn something.

For most of those days I'll actually be on vacation so it may take a bit for me to respond to any comments left on the post. Here's hoping everyone has a great holiday season!

Books I've Read This Week

noreply@blogger.com (Simon Mac Donald) — Fri, 16 Dec 2011 21:11:00 +0000

I know I hinted at a review for The Children of the Sky but I haven't finished with it yet so you'll have to be happy with:

Naruto, Vol. 52 is the last volume I'll be reading for awhile as I've completely caught up on the series with volume 53 just being released on Dec 6th and my local library does not have it yet. We get the beginnings of a battle between Naruto and Sasuke who were once best of friends but now are mortal enemies as Sasuke has been led down a dark path. Stop me if you've heard this one before. Anyway, I don't want to be flippant but you can see how Naruto is maturing so much so I'm beginning to like him more. Funny that the title's main character was not always your favourite character.

Morning Glories, Vol. 2 by Nick Spencer is like the movie The Breakfast Club mixed with a horror movie that's on crack. In the first volume we are introduced the the school, Morning Glory Academy but we don't really get to know a lot about the 6 kids that are the main characters as they are struggling to fit in and well not be killed by the school and the creepy faculty. Now in volume 2 we are treated to 6 individual stories each one focusing on a main character. We get to see there is more depth behind, the rich kid, the jock, the smart one, the geek, the cheerleader and the goth in a number of surprising ways. All the while Spencer is able to move the story forward while giving valuable background information.

Also, the series artist Joe Eisma is absolutely killing it and you should check this recent breakdown of his art on the series.

See you next Friday.

Books I've Read This Week

noreply@blogger.com (Simon Mac Donald) — Fri, 09 Dec 2011 16:29:00 +0000

Nothing to report this week. My daughter was sick for about five days with a fever/flu which cut into my reading time. I'm just cracking open The Children of the Sky by Vernor Vinge which promisses to be a great read.

See you next Friday.

Installing the Barcode Plugin for PhoneGap Android

noreply@blogger.com (Simon Mac Donald) — Fri, 02 Dec 2011 21:00:00 +0000

Some folks are having problems getting the Barcode Scanner plugin up and running for PhoneGap Android so I figured I'd write a more detailed explanation on how to get it up and running.

First you'll want to go download the Library Project part from GitHub. You'll want to use the code from github as I've modified it slightly so that it is responds to the correct intent.

Once downloaded you'll want to create a new Android project from existing source in Eclipse. The project name shows up as CaptureActivity but I'm going to change it to BarcodeLibrary which is more descriptive.

but don't click on Finish yet. Click the Next button...

and select the highest level of Android SDK you have installed before clicking Finish.

Now that you've created the library project which contains the barcode scanning code you'll want to right mouse click on the BarcodeLibrary project and select Properties. In the Properties dialog, select the Android tab and ensure the Is Library checkbox is click. The benefit of doing things this way is you can link this library into multiple Android projects without needing to copy a bunch of source around.

Now that we've got our library setup let's add it to our project. Right click on your PhoneGap project, in my case it is called BarTest, and select Properties.

In the Android tab under the library section click the Add button.

In the Project Selection dialog select BarcodeLibrary.

Now our application can use the BarcodeLibrary project so we can click OK.

Let's now add in the BarcodeScanning plugin code. Under the assets/www directory copy in the barcodescanner.js file from github. Under src, right click and create a new package com.phonegap.plugins.barcodescanner then copy in the BarcodeScanner.java file from github.

So were all set now right? Well know we forgot one thing. We need to add a line for our plugin under the res/xml/plugins.xml file so let's open that up now and add this line after the last <plugin/> tag but before the </plugins> line.

<plugin name="BarcodeScanner" value="com.phonegap.plugins.barcodescanner.BarcodeScanner"/>

Okay, so were good now. Well no, there is one more bit to take care of. Open up your AndroidManifest.xml file so we can add some new activities that will take care of the scanning and encoding. You'll need to paste these activity lines inside the <application/> tag.


<activity android:name="com.google.zxing.client.android.CaptureActivity"
    android:screenOrientation="landscape"
    android:configChanges="orientation|keyboardHidden"
    android:theme="@android:style/Theme.NoTitleBar.Fullscreen"
    android:windowSoftInputMode="stateAlwaysHidden">
  <intent-filter>
    <action android:name="com.phonegap.plugins.barcodescanner.SCAN"/>
    <category android:name="android.intent.category.DEFAULT"/>
  intent-filter>
activity>
<activity android:name="com.google.zxing.client.android.encode.EncodeActivity" 
    android:label="@string/share_name">
  <intent-filter>
    <action android:name="com.phonegap.plugins.barcodescanner.ENCODE"/>
    <category android:name="android.intent.category.DEFAULT"/>
  intent-filter>
activity>

Alright, finally we are all setup. But how does one call the BarcodeScanner? Well we provide two main piece of functionality.

Scan

window.plugins.barcodeScanner.scan( function(result) {
        alert("We got a barcode\n" +
                  "Result: " + result.text + "\n" +
                  "Format: " + result.format + "\n" +
                  "Cancelled: " + result.cancelled);
    }, function(error) {
        alert("Scanning failed: " + error);
    }
);

Encode

window.plugins.barcodeScanner.encode(BarcodeScanner.Encode.TEXT_TYPE, "http://www.nytimes.com", function(success) {
        alert("encode success: " + success);
      }, function(fail) {
        alert("encoding failed: " + fail);
      }
    );

I've put together a small example html (and css) page which will be listed below that you can use to test the BarcodeScanner.

If you have problems with the Barcode Scanner the best place to ask questions is over on the PhoneGap Google Group where I check multiple times per day for questions I can answer.