From 4d135090934add8f9fc2437247266b5f8efad538 Mon Sep 17 00:00:00 2001 From: Google Code Exporter Date: Tue, 5 Jan 2016 02:53:30 -0500 Subject: [PATCH] Migrating wiki contents from Google Code --- BuildInstructions.md | 59 ++++++++++++++++++++++++++++++++++++++++++++ GameMusic.md | 49 ++++++++++++++++++++++++++++++++++++ ProjectHome.md | 1 + 3 files changed, 109 insertions(+) create mode 100644 BuildInstructions.md create mode 100644 GameMusic.md create mode 100644 ProjectHome.md diff --git a/BuildInstructions.md b/BuildInstructions.md new file mode 100644 index 0000000..5860814 --- /dev/null +++ b/BuildInstructions.md @@ -0,0 +1,59 @@ +# Introduction # + +This Wiki entry details how to build Frozen Bubble for Android from the source code. + +# Details # + +To build the Frozen Bubble for Android application, you must first download the archive of the Android SDK ADT bundle. The ADT (Android Development Tools) bundle comes with Eclipse - Eclipse is the IDE. SDK stands for software development kit (the tools to build Android applications from source code), and IDE stands for integrated development environment (a graphical user interface that simplifies software development). + +http://developer.android.com/sdk/index.html + +Click the button on the side that says "Download the SDK ADT Bundle for Windows". If you are using Linux or an Apple computer, you will need the SDK for the appropriate operating system instead. After clicking this link, you will have to select the 32 or 64 bit version - the 64 bit version should be fine unless you are using Windows XP, which is 32-bit only. + +After you extract the SDK, you need to run the SDK manager, which is a program that is placed in the root of the extracted SDK folder. After you launch the SDK manager, you should see something like this: + +![http://imgur.com/peufLFg.jpg](http://imgur.com/peufLFg.jpg) + +At a minimum, you must select to install the Android 1.6 (API 4) SDK Platform. This is the API level for Frozen Bubble, which means that an Android device must have version 1.6 or later of Android to play the game. + +If you are building older versions of Frozen Bubble (version 1.12 and prior), at this point would be able to build the game - but now because of the addition of the native code for the music player, you need to download and install the Android NDK. NDK stands for "native development kit", where "native" refers to C/C++ code. The Android SDK only supports Java if you don't have the NDK. So, you must install the NDK to build the latest version (currently 1.15) of Frozen Bubble. + +http://developer.android.com/tools/sdk/ndk/index.html + +Once you have extracted the NDK, launch Eclipse - it is located in the Eclipse folder of the extracted SDK folder. You will have to add the path to the NDK to the environment, by selecting "Window → Preferences" in Eclipse. + +Select "NDK" under "Android" in the list on the left. **Note that the build path for the NDK isn't allowed to contain any spaces or the program won't compile**: + +![http://imgur.com/fzNmvqa.jpg](http://imgur.com/fzNmvqa.jpg) + +Next, you will have to get the source code for Frozen Bubble. I recommend using Tortoise SVN (again, I hope you are using Windows) as it is by far the easiest source control tool to work with. + +http://tortoisesvn.net/downloads.html + +After you install Tortoise SVN, simply right-click over a folder, then select "Tortoise SVN → Repo-browser", and then enter the following URL: + +http://frozenbubbleandroid.googlecode.com/svn + +Right-click the topmost level in the dropdown list on the left, then select "Export". Export everything into an empty folder on your computer: + +![http://imgur.com/9qW7ZI8.jpg](http://imgur.com/9qW7ZI8.jpg) + +**It has been noted that on the project source page, the instructions for checking out the code anonymously do not work, because this project does not have a trunk folder.** + +https://code.google.com/p/frozenbubbleandroid/source/checkout + +states that in order to check out the project anonymously you must use: + +http://frozenbubbleandroid.googlecode.com/svn/trunk/ frozenbubbleandroid-read-only + +Use this to anonymously check out the source instead: + +http://frozenbubbleandroid.googlecode.com/svn/ frozenbubbleandroid-read-only + +After the files are copied to your computer, you can import the project into Eclipse. Open Eclipse, then select "File → Import". Then select "Existing Projects into Workspace" under "General", and click "Next". + +Browse to the folder you placed the source files in with Tortoise SVN, and check "Copy projects into workspace": + +![http://imgur.com/hi7Ic3o.jpg](http://imgur.com/hi7Ic3o.jpg) + +Now, you should be able to build the project in Eclipse. \ No newline at end of file diff --git a/GameMusic.md b/GameMusic.md new file mode 100644 index 0000000..aa4792e --- /dev/null +++ b/GameMusic.md @@ -0,0 +1,49 @@ +# Music Copyright Notice # + +All the music used in this game is available free for download from the [Mod Archive](http://modarchive.org/). Each song is in its original module format with the information intact with regards to each song's title and author. Each song is the copyright of its respective author, and is not for commercial use unless permission or licensing is granted by the author. You may distribute this music freely without requiring explicit permission from the original artist as long as: + + * The songs are not altered in any way. + * Clear credit is given to the artists for their respective works. + * No fee is charged for distribution. + +The music is licensed under the [Mod Archive distribution license](http://modarchive.org/index.php?terms-upload). + +# Frozen Bubble Playlist # + +_After the Rain_ by Unknown Artist + +_Ambient Light_ by Vogue of Triton + +_Ambient Power_ by Vogue of Triton + +_Android Rupture_ by Baroque of Freelance + +_Artificial_ by Moby + +_Blue Stars_ by Blackstar\Timetraveller of Cryptoburners + +_Chunga-babe!_ by Yannis Brown + +_Crystalhammer_ by Karsten Obarski + +_Dreamscope I_ by Counterpoint of Westower + +_Freefall_ by Baroque of Freelance + +_Gaea's Awakening_ by Dreamsection + +_Homesick_ by Electric Keet + +_If Crystals…_ by Tran of Renaissance + +_Introzik_ by Matthias Le Bidan + +_Popcorn_ by Unknown Artist + +_Stardust Memories_ by Jester of Sanity + +_Sunshine of the Morning Sun_ by Area51 (Dan Nyman) + +_Technostyle III_ by Xenox of Triad + +_World of Peace_ by Zanoma (Marwan Green Critter) \ No newline at end of file diff --git a/ProjectHome.md b/ProjectHome.md new file mode 100644 index 0000000..263326c --- /dev/null +++ b/ProjectHome.md @@ -0,0 +1 @@ +The Android port of the Frozen Bubble game. Knock the bubbles down by making clusters of three or more bubbles in the same color. \ No newline at end of file