Development

SolitaireCG is a adaptation of Ken Magic's "Solitaire".

Source Code

The source code for SolitaireCG is managed under the git version control system.

See SolitaireCG git repository.

Building SolitaireCG

To build SolitaireCG be sure to choose the appropriate build process as follows:

For SolitaireCG version > 3.2.1 use build with gradle.
For SolitaireCG version <= 3.2.1 use build with ant.

Build with Gradle

NOTE: These instructions are intended for Android SDK >= 27.x.

The steps to build an app-debug.apk file are:

Set up a development environment for creating applications for Android™.

This involves installing the Android SDK, Java Development Kit, and git, in addition to other steps necessary to configure a development environment.

Note that installing gradle is not necessary as the gradlew build script will automatically download any necessary gradle components.

Clone the SolitaireCG git repository.

    git clone git://git.code.sf.net/p/solitairecg/code solitairecg-code

Change into the newly created SolitaireCG project directory.
```
    cd solitairecg-code
    
```
Build a debug apk file.
```
    ./gradlew assembleDebug
    
```
If all works correctly this should should build an app/build/outputs/apk/debug/app-debug.apk file.

Build with Ant

NOTE: These instructions are intended for Android SDK <= 25.x.

The steps to build a SolitaireCG-debug.apk file are:

Set up a development environment for creating applications for Android™.

This involves installing the Android SDK, Java Development Kit, ant, and git, in addition to other steps necessary to configure a development environment.

Clone the SolitaireCG git repository.

    git clone git://git.code.sf.net/p/solitairecg/code solitairecg-code

Change into the newly created SolitaireCG project directory.
```
    cd solitairecg-code
    
```
Build a debug apk file.
```
    $ ant debug
    
```
NOTE: Was bin/SolitaireCG-debug.apk file created?

If yes, then you can stop at this step.

Otherwise try the following additional steps.
List the valid target_IDs.
```
    android list targets
    
```

Select a target_ID and update the existing project files.

    rm build.xml
    android update project --target 1 --path .

Build a debug apk file.
```
    ant debug
    
```
If all works correctly, this should build a bin/SolitaireCG-debug.apk file.

Translations

Language tranlations of SolitaireCG are appreciated and make it easier for more people to enjoy playing the game.

The steps are as follows:

Download a recent copy of res/values/strings.xml.
Replace the English text between the <string> tags with your translation.
Either login to SourceForge.net and create a SolitaireCG Ticket,
Or email the translated strings.xml file to mailto: Curtis Gedak.

We like to provide credit for translation work, so please let us know what name and email address you would like published. You can also choose to remain anonymous and not have a name or email address published if you so wish.

For an example of language translation, see Ticket #6 - Add Finnish (fi) localization.

It is a good idea to test your translations. For example check the Select Game menu to ensure that the game names fit within the displayed menu.

Android is a trademark of Google Inc.