EducaTour Mobile Development

Architecture

App Screens/Components

Features

• Splash Screen
  Upon launching the application, a visually appealing splash screen featuring the EducaTour logo is displayed.
• Home
  The home screen serves as the central hub of the application, displaying a list of 25 notable landmarks. Users can easily access key features and guides from this screen.
• Detail
  This screen is displayed after selecting a landmark from the home screen list. It provides comprehensive information about the chosen landmark, including its name, description, historical background, location, photographs, unique activities available, opening hours, ticket prices, and contact information.
• Scanner
  The scanning feature allows users to capture images of historical sites using the device's camera or by selecting images from the gallery. The application analyzes these images to provide detailed information regarding the site's historical significance and key facts.
• Change Language
  Users can change the application's language preference between Indonesian, English, and Chinese, allowing them to interact with the app in their preferred language.
• About
  The about section provides information about EducaTour, including its purpose, mission, and the current version of the application.
• FAQ
  A section dedicated to frequently asked questions to assist users with common inquiries about the application’s features and functionalities.

Permission

• Internet
  The application requires internet access to communicate with the server and retrieve data for various features, including historical list, historical detail information, and historical landmark Scanner.
• Camera
  Camera permission is needed for the application to use the device's camera to capture images of historical sites.
• Read External Storage
  Permission to read external storage is necessary for the application to access the device's gallery, allowing users to select and upload images of historical sites.

Build With

• Kotlin - Version 2.0.0
• RecyclerView
• Retrofit2 - Version 2.11.0
• GSON Converter - Version 2.11.0
• OkHttp3 - Version 4.12.0
• Lifecycle - Version 2.8.1
• LiveData - Version 2.8.1
• ViewModel - Version 2.8.1
• Navigation Component - Version 2.7.7
• Glide - Version 4.16.0
• Room Database - Version 2.6.1
• DataStore - Version 1.1.1
• Coroutines - Version 1.9.0-RC
• CircleImageView - Version 3.1.0
• SplashScreen - Version 1.0.1
• Core KTX - Version 1.13.1
• JUnit - Version 4.13.2
• AppCompat - Version 1.7.0
• Material Components - Version 1.12.0
• Activity KTX - Version 1.9.0
• ConstraintLayout - Version 2.1.4
• Process Phoenix - Version 3.0.0
• Dagger - Version 2.51.1
• Legacy Support V4 - Version 1.0.0
• Fragment KTX - Version 1.7.1
• DataBinding - Version 8.4.1
• ThreeTenABP - Version 1.4.7

Requirement

• Android Studio
• Target device (Android device or emulator) with minimum android version of 7.0 (Nougat) or higher

Installation

1. Download or Clone this project to your computer

   • Repository Link: EducaTour/MoTour

   • Clone the repository:

     git clone https://github.com/EducaTour/MoTour.git

     -OR-

   • Download the repository:

     • On the GitHub repository page, click on the “Code” button and select “Download ZIP”.
     • Extract the downloaded ZIP file to your computer.

2. Open the project in Android Studio

3. Add Base URL in your gradle.properties

   BASE_URL=https://educatour-backend.swusjask.dev/

4. Run the application

   • Ensure you have either connected your Android device to your computer or set up an emulator as a target to run the application.
   • Click on the “Run” button (green triangle) in Android Studio’s toolbar to run the application.
   • The application will be installed on the selected device or emulator.

Download APP

Download the app from the following link:

• MoTour v1.0.0 Release

Download the apk-release.apk file from the release page.