tim95030 / androminion

Automatically exported from code.google.com/p/androminion
0 stars 0 forks source link

BUILDING THE APP

Building/debugging with ant

Make sure you have the android SDK installed (here is a good guide: http://developer.android.com/training/basics/firstapp/index.html), with whatever target is found in the project.properties under androminion/ and actionbarsherlock/ (in both the multiplayer branch and trunk, that is android-14 for actionbarsherlock/project.properties, and android-15 for androminion/project.properties; so, using the SDK manager that you'll find when you get the android SDK, be sure you install the "SDK Platform" for both API level 14 and API level 15).

With the SDK installed, you can just use ant to build the app (I think you can also run the app through Eclipse, but I don't know much about how that works - the guide linked above might help you if that's what you want to do). So cd into the androminion/ directory, then run the following two commands:

ant vdom_lib ant debug

The first command builds the vdom library code and puts a .jar file in the androminion directory, and the second command builds the app (including the actionbarsherlock code) in debug mode. There's probably a way to change the build files so you only need one command, but I didn't look hard enough to figure it out.

Once you've built the app, you can install it on your device using adb. There are instructions for that on the page linked above, too. The command, though, is

adb install -r bin/Androminion-debug.apk

The -r means "please overwrite any version already there". But it will probably fail the first time if you already have androminion installed from the play store, as it's signed by a different certificate. So you'll have to uninstall the version from the play store, then run the command.

Once it's installed, if you see a crash, you can get the log output by running

adb logcat

This could be long and obnoxious; what I like to do is run

adb logcat -c adb logcat -d |less

The -c in the first command clears the log (you do this just before doing something on the app that you know will crash it), and the -d in the second command dumps the log and exits, instead of continuously showing messages as they come in.

Building/debugging with Eclipse

TODO(matt): I don't use eclipse, so someone else should probably write this...


TODO(matt): I'm pretty sure everything under this point is out of date. I think there was a fork from Google code that got merged back in to the repository, bringing this file along with it.

  1. About this project

    This is a fork of androminion by Ankur Metah, originated from google code project "androminion", an android based implementation of the game "Dominion" by Rio Grande Games.

    This fork was originally based on version r561 (2012-08-02) of the official project and has since been updated up to r638 (2012-08-31).

    Goals of this fork are:

    • A better User Interface, first for smartphones and later for tablets (done)
    • Better AI players, possibly using a neural network (work in progress)
    • Possibly a separate server and multiplayer functionality (later)
    • And of course some bug fixing and code commenting (partly done)

    Licensed under LGPL: http://www.gnu.org/licenses/lgpl-3.0.html

  2. Branching strategy


    master: latest stable version, ready for production

    ^ |

    develop: contains changes in progress, may not be ready for production will be marged into master when in a stable, tested state

    ^ ^ ^ ^ ^ | | | | |

    topic branches (e.g. dev-ui or dev-bot): for working on a feature or bug fix, will then be merged into develop

    See also: http://stackoverflow.com/questions/2428722/git-branch-strategy-for-small-dev-team

  3. Import newest changes from Google Code SVN

    3.1 Prepare SVN synchronisation with SVN metadata (Do only once after cloning bitbucket repository)

    git checkout master
    git update-ref refs/remotes/trunk origin/master
    git svn init http://androminion.googlecode.com/svn/trunk/
    git svn fetch

    3.2 Copy newest changes in SVN to bitbucket

    git checkout master
    git svn fetch (or git svn rebase?)
    git push master

    3.3 Copy newest changes in git/bitbucket back to SVN

    git checkout master
    git svn dcommit
        --commit-url https://androminion.googlecode.com/svn/trunk/
        --username=google.user@gmail.com

    Merging seems only to work properly with the master branch, so this is used for synchronizing svn and git.