Skip to content

Home

Jump to bottom
Dmitry Sorokin (@sorydima) edited this page Nov 18, 2024 · 1 revision

Wiki for the Katya ® ExactCalculator Repository

Welcome to the Katya ® ExactCalculator repository! This wiki provides comprehensive information on using, developing, and contributing to ExactCalculator, a robust and precise calculator application for the Katya platform.

Overview

The ExactCalculator app is a feature-rich calculator designed for advanced and everyday calculations. Built with precision and ease of use in mind, it supports basic arithmetic, scientific functions, and extended functionalities tailored for developers and technical users.

Table of Contents

  1. Getting Started
  2. Repository Structure
  3. Features
  4. Installation
  5. Configuration
  6. Contributing
  7. Troubleshooting
  8. Licensing

Getting Started

  1. Clone the Repository

    git clone https://github.com/Katya-Incorporated/platform_packages_apps_ExactCalculator.git

  2. Set Up Development Tools
    Install Android Studio or another compatible IDE to modify and build the app.

  3. Explore the App
    Familiarize yourself with the interface and features available in the repository.

Repository Structure

  • /src: Source code for the calculator application.
  • /res: Resources like UI layouts, icons, and translations.
  • /docs: Additional documentation and usage guides.
  • /tests: Automated test cases for the app.
  • /build: Scripts and configurations for building the application.

Features

  1. Basic Arithmetic

    • Perform addition, subtraction, multiplication, and division effortlessly.

  2. Scientific Calculator Mode

    • Access advanced functions such as trigonometric, logarithmic, and exponential calculations.

  3. History Tracking

    • View and recall previous calculations for reference or reuse.

  4. Customizable Themes

    • Choose from multiple themes to personalize the app's appearance.

  5. Developer Tools

    • Built-in hexadecimal, binary, and octal conversions for programmers.

  6. Offline Support

    • Full functionality without requiring internet access.

Installation

  1. Build the Application
    Use Gradle to compile the application:

    ./gradlew assembleDebug

  2. Install the APK
    Deploy the APK to a device or emulator:

    adb install -r app/build/outputs/apk/debug/app-debug.apk

  3. Run the Calculator
    Open the ExactCalculator app and start performing calculations!

Configuration

  1. Set Default Mode

    • Access the settings to configure the default calculator mode (basic or scientific).

  2. Adjust Precision

    • Customize the number of decimal places for results.

  3. Themes and Accessibility

    • Change themes or enable high-contrast modes for better visibility.

Contributing

We welcome contributions to enhance the ExactCalculator application.

  1. Fork the Repository
    Create a personal copy of the repository on GitHub.

  2. Create a Branch
    Use descriptive branch names for your changes.

  3. Submit Pull Requests
    Provide detailed explanations of your modifications.

  4. Follow Guidelines
    Refer to the contribution guidelines for standards and best practices.

Troubleshooting

  1. Debugging Issues

    • Use adb logcat to view application logs and identify errors.

  2. Known Bugs

    • Visit the Issues page for open problems and fixes.

  3. Documentation

    • Review the /docs folder for additional troubleshooting tips.

Licensing

The ExactCalculator application is licensed under the Katya Open Source License. Use, modify, and share it under the terms of this license.

Thank you for using and contributing to Katya ® ExactCalculator! Together, we can build a powerful and accessible tool for all users.

Clone this wiki locally