Option 2: Install APK

1. Download the latest APK from the releases section
2. Enable Install from Unknown Sources in your device settings
3. Install the APK file

Usage

1. Launch the App

   • Open the Mock Location app from your app drawer

2. Enter Coordinates

   • Latitude: Enter a value between -90 and 90
   • Longitude: Enter a value between -180 and 180
   • Default values are set to Google's headquarters (37.4220, -122.0841)

3. Set Location

   • Tap the Set Location button
   • The mock location will be applied immediately

4. Verify Location

   • Open any map application (Google Maps, etc.)
   • Your location should appear at the coordinates you set

Project Structure

MockLocationApp/
├── app/
│   ├── src/
│   │   ├── main/
│   │   │   ├── java/com/example/mocklocation/
│   │   │   │   └── MainActivity.kt
│   │   │   ├── res/
│   │   │   │   ├── layout/
│   │   │   │   │   └── activity_main.xml
│   │   │   │   ├── values/
│   │   │   │   │   ├── colors.xml
│   │   │   │   │   ├── strings.xml
│   │   │   │   │   └── themes.xml
│   │   │   │   └── drawable/
│   │   │   └── AndroidManifest.xml
│   │   └── test/
│   └── build.gradle
├── gradle/
├── build.gradle
├── settings.gradle
└── README.md

Technical Implementation

Core Components

1. LocationManager: System service for managing location providers
2. Test Provider: Simulates GPS/Network location providers
3. FusedLocationProviderClient: Google Play Services location API
4. Material Components: Modern UI elements with Material Design

Key Methods

• checkLocationPermissions(): Verifies and requests necessary permissions
• checkMockLocationEnabled(): Checks if app is selected as mock location provider
• setMockLocation(): Validates input and sets mock location
• setMockLocationForProvider(): Configures mock location for specific provider

API Compatibility

The app handles different Android API levels:

• API 31+: Uses ProviderProperties for location provider configuration
• API 23-30: Uses deprecated Criteria constants for backward compatibility
• API 26+: Enhanced location accuracy parameters

Troubleshooting

Mock Location Not Working

1. Verify Developer Options are enabled
2. Confirm app is selected as mock location app
3. Check location permissions are granted
4. Ensure location services are enabled on device

App Crashes

1. Clear app data and cache
2. Reinstall the application
3. Check Android Studio logcat for error details

Location Not Updating

1. Force stop other location-based apps
2. Restart location services
3. Reboot your device

Development

Building the Project

# Clean build
./gradlew clean

# Build debug APK
./gradlew assembleDebug

# Build release APK
./gradlew assembleRelease

# Run tests
./gradlew test

Code Style

The project follows Kotlin coding conventions:

• 4 spaces for indentation
• CamelCase for class names
• camelCase for function and variable names
• ALL_CAPS for constants

Dependencies

• AndroidX Core KTX: 1.12.0
• AppCompat: 1.6.1
• Material Components: 1.11.0
• ConstraintLayout: 2.1.4
• Play Services Location: 21.0.1
• JUnit: 4.13.2 (testing)
• Espresso: 3.5.1 (UI testing)

Security Considerations

• This app requires mock location permissions which can only be granted through Developer Options
• Mock locations are only active while the app is running
• The app does not collect or transmit any location data
• All location data is processed locally on the device

Contributing

1. Fork the repository
2. Create your feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add some amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

License

This project is for educational purposes. Please ensure you comply with your local laws and regulations when using mock location functionality.

Disclaimer

This application is intended for development and testing purposes only. Users are responsible for ensuring their use of this app complies with all applicable laws and terms of service of other applications.

Support

For issues, questions, or suggestions, please open an issue on GitHub.

Version History

• 1.0 (Current)
  • Initial release
  • Basic mock location functionality
  • Material Design UI
  • Support for Android 6.0+

Future Enhancements

• Location history/favorites
• Map integration for visual location selection
• Automated location paths/routes
• Widget for quick location switching
• Export/Import location profiles
• Background service for continuous mock location
• Speed and altitude customization
• Multiple coordinate format support

A comprehensive personal finance tracker built with Kotlin & Android. Features expense/income tracking, budget management, visual analytics with pie charts, multi-currency support, user authentication, and intuitive UI. Includes transaction categorization, monthly budget monitoring, and data backup utilities.