Repository files navigation

Artemis is anart-sharing platform where the community can share and provide feedback on members’ works. While unregistered users are limited to viewing posted artworks and searching for posts and users, they can opt to register to maximize the features of the app. Registered users can log in to post their art and showcase some of their selected works on their profile using the Highlights feature. Moreover, they can provide their feedback on other artworks posted in the community by giving an upvote or leaving a comment.

Users also have the option to bookmark their favorite artworks made by other users so that they can view or return to them at a later time. Additionally, they can share posts on their Facebook accounts through its application programming interface (API). Users can search for a post by means of tags (e.g., “3D,” “watercolor,” and “pixel art”) and follow other users to see their posts in a dedicated section on their feed.

The source code documentation can be accessed through the following website:https://memgonzales.github.io/artemis-art-app/.

Artemis is the major course output in a mobile development class under Ms. Candy Joyce Espulgar of the Department of Software Technology, De La Salle University. The students are tasked to create an Android app of their choice, provided that it satisfied the minimum requirement of being connected to a remote server or featuring at least two of the following services: telephony, local database, geolocation, touch gestures that are non-native to the views used, camera usage, canvas or graphics-related applications, motion sensors, service that runs on the background, and usage of third-party APIs.

The application development is divided into two phases:

The project consists of the following folders:

Several Gradle-related files are also included in its root directory.

The complete project specifications can be found in the documentProject Specifications.pdf.

The minimum SDK supported is Android Lollipop (API Level 21), and the target SDK is Android 11 (API Level 30).

Download and install the APK file from the latest release. You may have to modify the security settings of your device to allow the installation of third-party apps from unknown sources.

1. Before running the application locally, the following software are recommended (albeit not required) to be installed:

   Software	Description	License
   git	Distributed version control system	GNU General Public License v2.0
   Android Studio	Official integrated development environment (IDE) for Android development	Apache License 2.0

2. Create a copy of this repository:

   • If git is installed, type the following command on the terminal:

     git clone https://github.com/memgonzales/artemis-art-app

   • If git is not installed, click the greenCode button near the top right of the repository and chooseDownload ZIP. Once the zipped folder has been downloaded, extract its contents.

3. Run the app using Android Studio (or any IDE that supports Android development). Alternatively, Android also provides aguide on how to build the app from the command line.

To test the Facebook sharing feature, log into Facebook using the following credentials:

• Email Address:tester.artemis@gmail.com
• Password:ASDFGHJKL123;

Using this tester account is necessary since the project has yet to undergo Facebook'sApp Review. Alternatively, send a Facebook friend request toArtemis Art App to be added as a tester.

This project uses the following project dependencies:

It also uses the following module-specific dependencies:

The descriptions are taken from their respective websites.

This project uses the following languages and technologies:

• Logic:Kotlin, a statically-typed language officially endorsed by Google as the preferred language for Android development
• Layouts:XML, a lightweight markup language that is both human- and machine-readable
• Database:Firebase Database, a cloud-based NoSQL database featuring real-time data synchronization

TheHTML documentation of the source code was generated fromKDoc comments via the documentation engineDokka.

Password encryption is implemented usingbcrypt andscrypt.

• Mark Edward M. Gonzales
  mark_gonzales@dlsu.edu.ph
  gonzales.markedward@gmail.com
  

• Hylene Jules G. Lee
  hylene_jules_lee@dlsu.edu.ph
  lee.hylene@gmail.com

• Phoebe Clare L. Ong
  phoebs_ong@dlsu.edu.ph
  ongphoebeclare@gmail.com

For queries or concerns related to the Artemis project, kindly emailartemis.appmaster@gmail.com.

Assets (images and XML-based layouts) are properties of their respective owners. Attribution is found in the filecredits.txt.