Skip to main content

​
Get started quickly

This guide will help you clone, build, and run the TechSales Android application on your development machine in just a few minutes.

​
Prerequisites

Before you begin, make sure you have the following installed:
  • Android Studio Hedgehog (2023.1.1) or later
  • Java Development Kit (JDK) 11 or higher
  • Android SDK with API level 29 or higher
  • Git for cloning the repository
TechSales requires a minimum SDK version of 29 (Android 10) and targets SDK 36. Make sure you have the appropriate SDK platforms installed in Android Studio.

​
Setup steps

1

Clone the repository

Open your terminal and clone the TechSales repository:
git clone https://github.com/danielamaya503/AndroidTechSales.git
cd AndroidTechSales/TechSales
2

Open in Android Studio

Launch Android Studio and select Open an Existing Project. Navigate to the cloned TechSales directory and click OK.Android Studio will automatically detect the project structure and begin syncing Gradle files.
3

Wait for Gradle sync

Android Studio will automatically sync the project dependencies. This may take a few minutes on the first run as it downloads:
  • Android Gradle Plugin 9.0.1
  • AndroidX AppCompat 1.6.1
  • Material Components 1.10.0
  • AndroidX Activity 1.8.0
  • ConstraintLayout 2.1.4
  • Testing libraries (JUnit, Espresso)
Wait for the sync to complete successfully. You’ll see “Gradle sync finished” in the status bar.
4

Configure Android SDK

Ensure you have the required SDK platforms installed:
  • Go to Tools > SDK Manager
  • Under SDK Platforms, check that Android API 36 is installed
  • Under SDK Tools, verify that Android SDK Build-Tools is installed
  • Click Apply if any installations are needed
5

Run the application

You can run TechSales on an emulator or physical device:Using an Emulator:
  1. Click Device Manager in Android Studio
  2. Create a new virtual device (Pixel 7 or similar recommended)
  3. Select a system image with API 29 or higher
  4. Click the Run button (green triangle) in the toolbar
Using a Physical Device:
  1. Enable Developer Options on your Android device
  2. Enable USB Debugging
  3. Connect your device via USB
  4. Select your device from the device dropdown
  5. Click the Run button
6

Verify the app is running

Once the build completes, the TechSales app will launch on your device or emulator. You should see:
  • The app icon on the home screen and app drawer
  • The main activity displaying “Hello World!” in the center
  • Edge-to-edge display with proper window insets handling
  • Material Design theming applied

​
Project configuration

TechSales is configured with the following settings in app/build.gradle.kts:14-18: 
applicationId = "com.teamtech.techsales"
minSdk = 29
targetSdk = 36
versionCode = 1
versionName = "1.0"

​
Key configuration details

Application ID

com.teamtech.techsales - The unique identifier for the app on Android devices and Google Play

Min SDK

API 29 (Android 10) - Supports 87% of devices worldwide

Target SDK

API 36 - Latest Android features and optimizations

Java Version

Java 11 - Modern language features and improved performance

​
Main activity

The app launches with MainActivity.java:11, which implements: 
public class MainActivity extends AppCompatActivity {
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        EdgeToEdge.enable(this);
        setContentView(R.layout.activity_main);
        ViewCompat.setOnApplyWindowInsetsListener(findViewById(R.id.main), (v, insets) -> {
            Insets systemBars = insets.getInsets(WindowInsetsCompat.Type.systemBars());
            v.setPadding(systemBars.left, systemBars.top, systemBars.right, systemBars.bottom);
            return insets;
        });
    }
}
This implementation provides:
  • EdgeToEdge display for immersive full-screen experience
  • Window insets handling to properly pad content around system UI
  • Material Design integration through AppCompatActivity

​
Build variants

TechSales includes standard Android build variants configured in app/build.gradle.kts:23-31:
  • Debug: Development builds with debugging enabled
  • Release: Production builds with ProGuard optimization disabled (can be enabled for production)

​
Troubleshooting

If Gradle sync fails:
  1. Check your internet connection (required for downloading dependencies)
  2. Verify JDK 11 or later is configured in Android Studio (File > Project Structure > SDK Location)
  3. Try File > Invalidate Caches > Invalidate and Restart
  4. Delete the .gradle folder in your project and sync again
If you see SDK-related errors:
  1. Open Tools > SDK Manager
  2. Install Android API 36 under SDK Platforms
  3. Install Android SDK Build-Tools under SDK Tools
  4. Sync the project again
If the app crashes immediately:
  1. Check the Logcat output in Android Studio for error messages
  2. Verify your device/emulator is running Android 10 (API 29) or higher
  3. Clean and rebuild: Build > Clean Project, then Build > Rebuild Project
TechSales requires Java 11. If you encounter version issues:
  1. Go to File > Project Structure > SDK Location
  2. Set the JDK location to JDK 11 or later
  3. Verify the gradle.properties file doesn’t override Java version
  4. Sync the project

​
Next steps

Now that you have TechSales running, you can:

Explore the code

Learn about the app architecture and project structure

Start developing

Begin building features and customizing the app

Run tests

Execute unit tests and instrumented tests

Build for release

Create production builds for distribution

​
Resources

Build docs developers (and LLMs) love

Get started for freeTalk to us