This is the repository for our Android app, The DM's Grimoire, for DMs/GMs of the tabletop role-playing game Dungeons and Dragons. It features a section for the DM's campaign(s) and notes for each. The application also has databases of items, spells, monsters, etc. for the DM to use in constructing and running their games. For a more detailed description of the application and its capabilities, check the repository's wiki page here.
This application follows Google's Style Guide for Java
To build this application, you'll need the following:
sudo apt update
sudo apt install -y openjdk-18-jdk
sudo apt install -y openjdk-18-jre- Visit this website
- Then download and unpack the android-studio-<version.number>-linux.tar.gz
- Once unpacked, run the contained studio.sh file and follow all subsequent instructions
- To import the project, choose "From VCS" in the project creation menu and select the SCCapstone/BoredBards repository
Add the following to your $HOME/.bash_profile or $HOME/.bashrc
export ANDROID_SDK_ROOT=$HOME/Library/Android/Sdk
export PATH=$PATH:$ANDROID_SDK_ROOT/emulator
export PATH=$PATH:$ANDROID_SDK_ROOT/platform-toolsDownload Android Studios through the Android Studio website
Install the package and then follow the instructions given
This can be either a physical device or, more commonly, an Android Virtual Device (accessible from Android Studio)
- Visit this website to download an Android Virtual Device (AVD) for when a physical android phone is not available to test
To run the application, choose an AVD from Android Studio's lists of virtual devices or connect a physical device to your machine and select it. Then, run the application from Android Studio
To deploy the application, follow the relevant instructions listed at this website. In short, you need to remove any calls to Log and the android:debuggable attribute from the manifest file. With Gradle, you can use the release build type to set build settings for the published version of the application
- Unit tests are located in the directory labeled: app/src/test/java/com/example/bored_bard
- Instrumentation tests are located in the directory labeled: app/src/androidTest/java/com/example/bored_bard
These instructions assume that testing is being done within the Android Studio IDE (for other testing instructions, see the official Android Documentation here)
- To run any one of the test methods, right-click the method or class and select the "Run " option in the menu
- To run all instrumented test methods, right-click the app/src/androidTest/java/com/example/bored_bard directory and select the "Run tests in " option in the menu
- To run all unit test methods, right-click the app/src/test/java/com/example/bored_bard directory and select the "Run tests in " option in the menu
- To run the test methods for the Campaign UI, right-click the app/src/androidTest/java/UITestingforCampaignMenu directory and select the "Run tests in " option in the menu
- Alternatively, you can run a test by selecting it from the menu next to the "Build" button and then clicking "Run"
Jake Powers, Caroline Barrineau, Charles Simons, Andrew MacMurray