Installation

Installation overview

This comprehensive guide walks you through setting up a complete development environment for TechSales Android, from installing Android Studio to running your first build.

System requirements

Before installing, verify your system meets these requirements:

Hardware requirements

RAM: 8 GB minimum, 16 GB recommended
Disk Space: 10 GB minimum for Android Studio + SDK
Display: 1280 x 800 minimum screen resolution
Processor: x86_64 CPU architecture; 2nd generation Intel Core or newer, or AMD equivalent

Operating system requirements

Windows
macOS
Linux

Windows 10 (64-bit) or later
Windows Subsystem for Linux (WSL) not required but optional

Install Java Development Kit

TechSales requires Java 11 as specified in app/build.gradle.kts:32-35:

compileOptions {
    sourceCompatibility = JavaVersion.VERSION_11
    targetCompatibility = JavaVersion.VERSION_11
}

Download JDK 11

Download and install JDK 11 or later:

Oracle JDK: Download from Oracle
OpenJDK: Download from Adoptium
Amazon Corretto: Download from AWS

Verify Java installation

Open a terminal or command prompt and verify the installation:

java -version

You should see output indicating Java version 11 or higher:

openjdk version "11.0.x" ...

Set JAVA_HOME environment variable

Set the JAVA_HOME environment variable to point to your JDK installation:

Windows
macOS/Linux

Open System Properties > Advanced > Environment Variables
Click New under System Variables
Set Variable Name: JAVA_HOME
Set Variable Value: Path to JDK (e.g., C:\Program Files\Java\jdk-11)
Click OK

Add to your ~/.bashrc, ~/.zshrc, or ~/.profile:

export JAVA_HOME=/path/to/jdk-11
export PATH=$JAVA_HOME/bin:$PATH

Then reload:

source ~/.bashrc  # or ~/.zshrc

Install Android Studio

Download Android Studio

Download the latest version of Android Studio from the official website:Download Android Studio

TechSales is compatible with Android Studio Hedgehog (2023.1.1) or later. The latest version is recommended for best performance and features.

Run the installer

Windows
macOS
Linux

Run the .exe installer
Follow the setup wizard
Choose Standard installation type
Select a theme (optional)
Review settings and click Finish

Open the .dmg file
Drag Android Studio to Applications folder
Launch Android Studio from Applications
Follow the setup wizard
Choose Standard installation

Extract the .tar.gz file:
```
tar -xzf android-studio-*.tar.gz
```
Navigate to the android-studio/bin/ directory:
```
cd android-studio/bin
```
Run the studio.sh script:
```
./studio.sh
```
Follow the setup wizard

Complete Android Studio setup wizard

On first launch, Android Studio will:

Check for existing SDK installations
Download Android SDK components
Download Android SDK Platform-Tools
Download Android Emulator
Configure default settings

This process may take 10-20 minutes depending on your internet connection.

Configure Android SDK

TechSales requires specific SDK components based on its configuration:

Open SDK Manager

In Android Studio:

Click Tools > SDK Manager
Or click the SDK Manager icon in the toolbar
Or go to File > Settings > Appearance & Behavior > System Settings > Android SDK

Install SDK platforms

Under the SDK Platforms tab, install:

Android API 36 (Android 15) - Required for targetSdk = 36
Android API 29 (Android 10) - Required for minSdk = 29
Android API 34 (Android 14) - Recommended for testing

TechSales compiles against SDK 36 with minorApiLevel = 1 as specified in app/build.gradle.kts:7-11.

Install SDK tools

Under the SDK Tools tab, ensure these are installed:

Android SDK Build-Tools (latest version)
Android Emulator
Android SDK Platform-Tools
Intel x86 Emulator Accelerator (HAXM installer) (Windows/Linux)
Google Play services (optional, for future features)

Accept licenses

Click Apply to download and install selected components. You’ll need to accept Android SDK licenses:

Review each license agreement
Click Accept
Click Next or Finish

Alternatively, accept all licenses from the command line:

cd $ANDROID_HOME/cmdline-tools/latest/bin
./sdkmanager --licenses

Clone and import TechSales project

Clone the repository

Clone the TechSales repository to your local machine:

git clone https://github.com/danielamaya503/AndroidTechSales.git
cd AndroidTechSales/TechSales

Open project in Android Studio

In Android Studio:

Select File > Open
Navigate to the cloned TechSales directory
Select the root folder (containing settings.gradle.kts)
Click OK

Wait for initial Gradle sync

Android Studio will automatically start syncing the project. This involves:

Reading project configuration from settings.gradle.kts:25-26:
```
rootProject.name = "TechSales"
include(":app")
```
Downloading dependencies from gradle/libs.versions.toml:11-18:
- androidx.appcompat:appcompat:1.6.1
- com.google.android.material:material:1.10.0
- androidx.activity:activity:1.8.0
- androidx.constraintlayout:constraintlayout:2.1.4
Configuring build tools (Android Gradle Plugin 9.0.1)

The first Gradle sync can take 5-15 minutes as it downloads all dependencies. Subsequent syncs will be much faster.

Configure JDK in Android Studio

If prompted, configure the JDK:

Go to File > Project Structure > SDK Location
Under JDK location, click the dropdown
Select Download JDK or choose an existing JDK 11+ installation
Click Apply and OK

Verify Gradle sync success

Check the Build panel at the bottom of Android Studio:

Success message: “Gradle sync finished in Xs”
No error messages in the sync log
Project structure visible in the Project panel

If sync fails, see Troubleshooting below.

Setup Android emulator

Open Device Manager

In Android Studio:

Click Tools > Device Manager
Or click the Device Manager icon in the toolbar

Create virtual device

Click Create Device
Select a device definition (Pixel 7 recommended)
Click Next

Select system image

Choose a system image with API 29 or higher
Recommended: API 34 (Android 14) with Google APIs
Click Download if not already installed
Click Next

Configure AVD

Name your AVD (e.g., “Pixel_7_API_34”)
Select Portrait orientation
Enable Hardware - GLES 2.0 for better graphics
Click Finish

Launch emulator

Click the Play button next to your AVD in Device Manager to start the emulator.

Verify installation

Build the project

Trigger a full build to verify everything is configured correctly:

Click Build > Clean Project
Wait for completion
Click Build > Rebuild Project

Check the Build panel for any errors.

Run TechSales

Select your device/emulator from the device dropdown
Click the Run button (green triangle)
Wait for the build and deployment to complete

Verify app launch

The app should launch and display:

Main activity with “Hello World!” text centered on screen
Edge-to-edge layout properly handling system bars
Material Design theme applied
No crashes or errors in Logcat

Check Logcat output

Open the Logcat panel and verify:

MainActivity: onCreate called
EdgeToEdge enabled
Window insets applied

No error or warning messages related to TechSales.

Project dependencies

TechSales uses the following dependencies managed through Gradle Version Catalogs:

Core libraries

[libraries]
appcompat = { group = "androidx.appcompat", name = "appcompat", version = "1.6.1" }
material = { group = "com.google.android.material", name = "material", version = "1.10.0" }
activity = { group = "androidx.activity", name = "activity", version = "1.8.0" }
constraintlayout = { group = "androidx.constraintlayout", name = "constraintlayout", version = "2.1.4" }

Testing libraries

junit = { group = "junit", name = "junit", version = "4.13.2" }
ext-junit = { group = "androidx.test.ext", name = "junit", version = "1.1.5" }
espresso-core = { group = "androidx.test.espresso", name = "espresso-core", version = "3.5.1" }

All dependencies are declared in app/build.gradle.kts:38-46 and resolved from Google and Maven Central repositories configured in settings.gradle.kts:17-23.

Troubleshooting

Gradle sync fails with 'SDK not found'

Open File > Project Structure > SDK Location
Verify the Android SDK location points to a valid SDK installation
If empty or incorrect, click the folder icon and select your SDK directory
Typical locations:
- Windows: C:\Users\<username>\AppData\Local\Android\Sdk
- macOS: /Users/<username>/Library/Android/sdk
- Linux: /home/<username>/Android/Sdk
Click Apply and sync again

Java version mismatch errors

TechSales requires Java 11. If you see version errors:

Verify your JDK installation: java -version
In Android Studio: File > Project Structure > SDK Location
Under Gradle Settings, ensure JDK 11+ is selected
If needed, click Download JDK and select version 11 or higher
Click Apply and restart Android Studio

Unable to download dependencies

If Gradle cannot download dependencies:

Check your internet connection
Verify repository URLs in settings.gradle.kts:1-23
If behind a corporate proxy, configure proxy settings:
- File > Settings > Appearance & Behavior > System Settings > HTTP Proxy
Try File > Invalidate Caches > Invalidate and Restart
Delete ~/.gradle/caches and sync again

Android Gradle Plugin version error

TechSales uses AGP 9.0.1 as specified in gradle/libs.versions.toml:2:

agp = "9.0.1"

If you encounter AGP version issues:

Ensure Android Studio is up to date (Hedgehog or later)
Check Gradle wrapper version in gradle/wrapper/gradle-wrapper.properties
AGP 9.0.1 requires Gradle 8.0 or later
Update if necessary: File > Project Structure > Project > Gradle Version

Emulator fails to start

If the Android Emulator fails to start:

Check virtualization is enabled in BIOS (Intel VT-x or AMD-V)
On Windows, ensure Hyper-V is disabled if using HAXM
Increase RAM allocated to AVD (2GB minimum, 4GB recommended)
Try creating a new AVD with a different system image
Check disk space (emulators require 5-10GB free space)

Build succeeds but app crashes on launch

If the app builds but crashes immediately:

Check Logcat for stack traces
Verify device/emulator is running API 29 or higher (TechSales minSdk)
Ensure system images include Google APIs if needed
Try Build > Clean Project then rebuild
Check AndroidManifest.xml:1 for configuration errors

Next steps

With TechSales installed and running, you’re ready to:

Explore architecture

Understand the app structure and design patterns

Start development

Begin building features and customizing the app

Configure build

Customize build variants and signing configs

Run tests

Execute unit and instrumented tests

Get Started

Development

Components

Configuration

Deployment

Installation overview

System requirements

Hardware requirements

Operating system requirements

Install Java Development Kit

Install Android Studio

Configure Android SDK

Clone and import TechSales project

Setup Android emulator

Verify installation

Project dependencies

Core libraries

Testing libraries

Troubleshooting

Next steps

Explore architecture

Start development

Configure build

Run tests

Additional resources

Build docs developers (and LLMs) love

Get Started

Development

Components

Configuration

Deployment

​Installation overview

​System requirements

​Hardware requirements

​Operating system requirements

​Install Java Development Kit

​Install Android Studio

​Configure Android SDK

​Clone and import TechSales project

​Setup Android emulator

​Verify installation

​Project dependencies

​Core libraries

​Testing libraries

​Troubleshooting

​Next steps

Explore architecture

Start development

Configure build

Run tests

​Additional resources

Build docs developers (and LLMs) love

Installation overview

System requirements

Hardware requirements

Operating system requirements

Install Java Development Kit

Install Android Studio

Configure Android SDK

Clone and import TechSales project

Setup Android emulator

Verify installation

Project dependencies

Core libraries

Testing libraries

Troubleshooting

Next steps

Additional resources