Unciv/docs/Developers/Building-Locally.md

Building Locally

This is a guide to editing, building, running and deploying Unciv from code

So first things first - the initial "No assumptions" setup to have Unciv run from-code on your computer!

With Android Studio

• Install Android Studio - it's free and awesome! Be aware that it's a long download!
• Install Git, it's the way for us to work together on this project. UI is optional, Android Studio has good Git tools built in :)
• Getting the code
  • Create a Github account, if you don't already have one
  • Fork the repo (click the "Fork" button on the top-right corner of https://github.com/yairm210/Unciv) - this will create a "copy" of the code on your account, at https://github.com/YourUsername/Unciv
  • Clone your fork with git - the location will be https://github.com/YourUsername/Unciv.git, visible from the green "Clone or download" button at https://github.com/YourUsername/Unciv
• Load the project in Android Studio, Gradle will attempt the initial sync. If this is your first time with Android Studio, this may require you to accept the Android Build-tools licenses, which works differently on every device, so search for your OS-specific solution.
  • A new install may not be able to do the initial sync - this comes in the form of Unable to find method ''void org.apache.commons.compress.archivers.zip.ZipFile.<init>(java.nio.channels.SeekableByteChannel)'' errors when you try to sync. If you have this problem go into File > Settings > Appearance & Behavior > System Settings > Android SDK
    • Click "SDK Platforms"
    • Click "Android 11.0 (R)"
    • Click "SDK Tools"
    • Select "Show Package Details" in the bottom right
    • Choose version 30.0.3 under "Android SDK Build-Tools "
    • Click "Apply"
• In Android Studio, Run > Edit configurations.
  • Click "+" to add a new configuration
  • Choose "Application"
  • Set the module to Unciv.desktop, main class to com.unciv.app.desktop.DesktopLauncher and <repo_folder>\android\assets\ as the Working directory, OK to close the window
    • If you get a ../../docs/uniques.md (No such file or directory) error that means you forgot to set the working directory!
• Select the Desktop configuration and click the green arrow button to run!
• I also recommend going to Settings > Version Control > Commit and turning off 'Before commit - perform code analysis'

Unciv uses Gradle to specify dependencies and how to run. In the background, the Gradle gnomes will be off fetching the packages (a one-time effort) and, once that's done, will build the project!

Unciv uses Grade 7.2 and the Android Gradle Plugin 7.1.0

Without Android Studio

If you also have JDK 11 installed, you can compile Unciv on your own by cloning (or downloading and unzipping) the project, opening a terminal in the Unciv folder and run the following commands:

Windows

• Running: gradlew desktop:run
• Building: gradlew desktop:dist

Linux/Mac OS

• Running: ./gradlew desktop:run
• Building: ./gradlew desktop:dist

If the terminal returns Permission denied or Command not found on Mac/Linux, run chmod +x ./gradlew first. This is a one-time procedure.

If you get an error that Android SDK folder wasn't found, firstly install it by doing in terminal:

sudo apt update && sudo apt install android-sdk (Debian, Ubuntu, Mint etc.)

After that you should put its folder to the file local.properties by adding this line:

sdk.dir = /path/to/android/sdk which can be /usr/lib/android-sdk or something other.

If during the first launch it throws an error that the JDK version is wrong try this JDK installation.

Gradle may take up to several minutes to download files. Be patient. After building, the output .JAR file should be in /desktop/build/libs/Unciv.jar

For actual development, you'll probably need to download Android Studio and build it yourself - see Contributing :)

Next steps

Congratulations! Unciv should now be running on your computer! Now we can start changing some code, and later we'll see how your changes make it into the main repository!

Now would be a good time to get to know the project in general at the Project Structure overview!