This sample demonstrates how to set the phone's wallaper from a BlackBerry WebWorks application for BlackBerry 10.
The sample code for this application is Open Source under the Apache 2.0 License.
To contribute code to this repository you must be signed up as an official contributor.
The documentation for this API is available at https://developer.blackberry.com/html5/apis/blackberry.system.html#.setWallpaper
The following feature must be included in your project's config.xml.
<feature id="blackberry.system" />
Setting the Wallpaper
This API is really easy to use. To set the Wallpaper simply pass in the path to the image you wish to use. In this sample a FilePicker is opened to select an image.
Clone this repo to your local machine.
Ensure the BlackBerry 10 WebWorks SDK 2.0 is correctly installed.
Open a command prompt (windows) or terminal (mac) and run the following command:
webworks create <your source folder>\SetWallpaper
Replace the default SetWallpaper\www folder with the \www folder from this project
Replace the default SetWallpaper\config.xml with the config.xml from this project
From the command prompt (Windows) or terminal (mac), navigate to the SetWallpaper folder
cd <your source folder>\SetWallpaper
Run the following commands to configure plugins used by this app
webworks plugin add com.blackberry.app webworks plugin add com.blackberry.invoke.card webworks plugin add com.blackberry.ui.toast webworks plugin add com.blackberry.system
Run the following command to build and deploy the app to a device connected via USB
- BlackBerry HTML5 WebWorks - Downloads, Getting Started guides, samples, code signing keys.
- BlackBerry WebWorks Development Guides
- BlackBerry WebWorks Community Forums
Please see the README of the BB10-WebWorks-Samples repository for instructions on how to add new Samples or make modifications to existing Samples.
If you find a bug in a Sample, or have an enhancement request, simply file an Issue for the Sample.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.