[2.1] Adding links to your wallpaper settings

Here's a short guide on (one of the many ways on) how to add links to your live wallpaper settings. I might do a video later, when I have more time.

Objective:
To add a setting to our live wallpaper that, when clicked on, it opens the browser and takes the user to the specified link/URL.

Files you need to edit:
LiveWallpaperSettings.java (found in the src folder of your project)
lwp_settings.xml (found in the xml folder of your project)

Step 1 - Adding the setting:
The file lwp_settings.xml organizes all the settings that you see in your live wallpaper projects. They are called preferences in Android. So in order to add another one, we have to modify that file. The following code is just an example. Keep in mind that the placement of this code, in respect to the other stored preferences, impacts its location in the wallpaper settings.

Code (text):

<Preference
            android:title="This is an ad supported version"
            android:summary="Click here to buy the ad-free version on Google Play."
            android:key="go_to_ad_free" />

Title - The title of the setting.
Summary - Usually a brief description of the setting and what it does.
Key - A reference point that we will use internally later.

Step 2 - Adding the java code:
The file LiveWallpaperSettings.java contains the java code that displays the contents of lwp_settings.xml. So now we need to add some Java code that will open a browser on the user's phone and take them to our link. In our example, I want the user to go to the Google Play page with the ad-free version of our wallpaper, with hopes that they will purchase it

First find the following line in file LiveWallpaperSettings.java:

Code (text):

PreferenceCategory main_preference_category = (PreferenceCategory) findPreference("main_preference_category");

Paste the following code just underneath that line:

Code (text):

        getPreferenceManager().findPreference("go_to_ad_free")
                .setOnPreferenceClickListener(
                        new OnPreferenceClickListener() {
                            @Override
                            public boolean onPreferenceClick(
                                    Preference preference) {
                                Intent intent = new Intent(Intent.ACTION_VIEW);
                                intent.setData(Uri
                                        .parse("https://play.google.com/store/apps/details?id=SeriousBusinessGroup.adfree.supersaiyanlwp"));
                                startActivity(intent);
                                return true;
                            }
                        });

I won't get into the details of what each line does. Basically, we say find preference with the key of "go_to_ad_free" (remember the key value from before?), and if the user clicks on it open this URL. In our case, the URL leads to the market.

Now, Eclipse (I used Eclipse as my Java IDE) will probably show you some red squiggly lines. We need to fix them before we finish. Eclipse offers some quick fix solutions, but to avoid confusion, we will fix it ourselves.

Find the following line in your LiveWallpaperSettings.java:

Code (text):

import android.preference.PreferenceCategory;

Now add the following code below:

Code (text):

import android.content.Intent;
import android.net.Uri;
import android.preference.Preference.OnPreferenceClickListener;

That's it! Save your files and test out the changes. I will probably put up my modified wallpaper on Google Play for everyone to see in the coming days. Hopefully, I will have more time to make a video and include some screenshots, but this should get you started!

If you have any questions, just post here. Good luck!

Perfect! Glad to hear that.
You can add as many links as you want with this tutorial

Changing backgrounds and falling item sets is a little harder, but it's not rocket science. I'll see if I can get around to it sometime.

Hard to say from that error message. It's pretty general.
It's possible that you missed something. I would say check to make sure you followed all the steps correctly. Even a typo in one place can break functionality.

Repeat step 1 and 2, changing the android:key and the corresponding call for it in findPreference() to a new matching value. If it doesn't work, you probably did something wrong.