From the device, open the File Manager and find the file that you copied to the device and tap on it to execute the installer. The program will be installed in the "Program Files\Gospel Library" folder and the application's executable is called "MSWM" (which stands for Mobile Scriptures Windows Mobile). To run the program, simply tap on this file. Note: A shortcut will also be installed under either the "Start Menu" or "Start Menu > Programs" (depending on the OS), called "LDS Gospel Library."

If, when trying to execute the LDS Gospel Library program, you get the following error, "This application requires a newer version of the Microsoft .NET Compact Framework than the version installed on this device", then you can download and install this updated version of the .NET Framework. The Gospel Library application requires 3.5 of the .NET framework or higher. When installing, we recommend selecting the the "Deployment" feature for installation, as this is the easiest method to deploy the compact framework to your device (via ActiveSync or Windows Mobile Device Center).

Important Notes: This release also has known issues when running on emulators. Specifically, the program will report failures when modifying downloaded content, saving notes, highlighting verses, or otherwise modifying the local database. This is a known issue with the virtual storage emulator, and while the failures will be reported, the changes will nevertheless be successful. It is, therefore, not recommended for use on emulators or standard devices (non-touch).

This project makes use of the ADO.NET 2.0 Provider for SQLite. Download and install the SDK.

Set up Storage Card Emulator

Open Visual Studio

Navigate to Tools > Options

Navigate to Device Tools > Devices

Select Windows Mobile 6 Professional Emulator

Select Properties

Select Emulator Options

Specify a Shard Folder (e.g., "c:\temp")

Click OK

Click OK

Click OK

Build the Project

Navigate to Build > Build Solution to build all the project files.

Run the Project

Navigate to Debug > Start Debugging to run the project in debug mode. The initial deployment to the emulator will take a while, as it will install the .NET Compact Framework and copy the SQLite scriptures database for the first time.

Saving Emulator State

When closing the emulator, save the emulator state if prompted. This will prevent the initialization process from running again (installing .NET and copying the database file).

Set up network access (optional)

Note: Network configurations vary, so you may need to specify a network adapter IP address or proxy information within the Windows Mobile device before access to the Internet will work. These instructions are intended to provide basic guidelines to enable Internet access on a Windows Mobile 6.1.4 Professional emulator image connected via a wired network where DHCP is enabled and proxies are not used.

Open Visual Studio

Navigate to "Tools > Options"

Expand "Device Tools" and select "Devices"

Select the desired device image (for the purpose of this write up, I will use the device image called "USA Windows Mobile 6.1.4 Professional Emulator", and OS specific steps will vary, but the same principles apply)

Click the "Properties" button

Click the "Emulator Options" button

Click the "Network" tab

Check the "Enable NE2000 PCMCIA network adapter and bind to:"

From the drop down list, select the desired network card (or select "Connected network card" if you only have one network interface).

Click OK, OK, OK

Start the device emulator with the device image you just configured

Select the "Start" menu

Select "Settings"

Select the "Connections" tab

Select "Network Cards"

Under "My network card connects to:" select "The Internet"

Note: In our testing, we have found that wireless connections do not generally connect even after following these instructions. Using a wired connection resolved the issues we encountered.

UI concepts

The application uses a concept similar to the iPhone UI, but with a black and white color scheme.