Home

Welcome to the privacy-friendly-boardgame-clock wiki!

Functionality of privacy-friendly-boardgame-clock

Privacy Friendly Boardgame Clock can be used with its different functionalities to count time while playing board games. The main functionalities are:

• 5 different Clock Modes - Clockwise, counter-clockwise, random order, manual sequence and time tracking mode. Other than that there are different properties like chess clock, infinite game time, reset round time after each round or increase round time after each round.
• resuming saved games
• the counting happens in an foreground service. The app can be killed or shuted down while counting without interfering with the counting result
• player management and player history. Player can also import player from contacts
• game history is kept
• export/import a backup file (read/write permissions in storage is required)

Used Technology and Libraries

• unified PFA Design is used through out the app
• the app supports SDK from 21 to 27

Introduction to futher development

packages and app structure explained

org.secuso.privacyfriendlyboardgameclock.activities

This package contains every single activity of the App. The App consists of only activities and DialogFragments. In order to avoid Bugs and Errors, Activitys are prefered over Fragments. First up one can see that each item on the Navigation Drawer represents an Activity:

• Main - MainActivity
• Player Management - PlayerManagementActivity
• Game History - GameHistoryActivity
• Backup - BackUpActivity
• Help - HelpActivity
• About - AboutActivity Moreover almost every Activity in this app extends from BaseActivity. In the BaseActivity the ground structure of the Activity and common Methods are declared. Therefore each Activity which extends from the BaseActivity must implement the method "getNavigationDrawerID".

org.secuso.privacyfriendlyboardgameclock.database

This package consists of 4 classes which are responsible for the communication with the database. All the necessary methods for the communication with the database are defined in the 2 classes GamesDataSourceSingleton and PlayersDataSourceSingleton. The Singleton classes can be accessed with the getInstance method. Before accessing the database, this must be opened with the open() method. And when the App is closed completely, close() method must be called in order to prevent memory leakage. Other than that, list of games, players can be retrieved and manipulated from the database with the existing methods such as: getAllGames, getSavedGames, createGame, etc.