@gengjiawen/os-init 1.5.1 → 1.7.0

package/.husky/pre-commit

@@ -0,0 +1 @@
+pnpm lint-staged

package/CHANGELOG.md

@@ -1,5 +1,24 @@
 # Changelog
 
+## [1.7.0](https://github.com/gengjiawen/os-init/compare/v1.6.0...v1.7.0) (2025-11-09)
+
+
+### Features
+
+* add setup android sdk ([cb18d40](https://github.com/gengjiawen/os-init/commit/cb18d40e53e312b0aedc66a9cde6738bc2f4f1ba))
+
+## [1.6.0](https://github.com/gengjiawen/os-init/compare/v1.5.1...v1.6.0) (2025-10-25)
+
+
+### Features
+
+* update Docker configuration to expose additional ports for development ([c1f0be1](https://github.com/gengjiawen/os-init/commit/c1f0be1f5f7559a32cbb2e5f1a829fd79f85d910))
+
+
+### Bug Fixes
+
+* set-dev build issues ([728c0e9](https://github.com/gengjiawen/os-init/commit/728c0e9964d19cdd7624a7e9c5f2e68efaf4858f))
+
 ## [1.5.1](https://github.com/gengjiawen/os-init/compare/v1.5.0...v1.5.1) (2025-10-25)
 
 

package/README.md

@@ -1,5 +1,7 @@
 ## os-init CLI
 
+[![npm version](https://img.shields.io/npm/v/%40gengjiawen%2Fos-init)](https://www.npmjs.com/package/@gengjiawen/os-init)
+
 A CLI tool to quickly configure AI development tools and environments.
 
 ## Usage
@@ -52,6 +54,32 @@ Example:
 pnpx @gengjiawen/os-init set-dev "ssh-rsa AAAAB3NzaC1yc2..."
 ```
 
+### Setup Android Development Environment
+
+```bash
+pnpx @gengjiawen/os-init set-android [options]
+```
+
+Sets up a complete Android development environment on macOS and Linux. This command will:
+- Install Android SDK to `~/Android` (or custom path with `--android-home <path>`)
+- Download and install Android SDK Command-line Tools, Platform Tools, Build Tools, CMake, and NDK
+- Automatically accept Android SDK licenses
+- Configure environment variables in your shell config (~/.bashrc, ~/.zshrc, or ~/.config/fish/config.fish)
+- Works on both macOS (Intel and Apple Silicon) and Linux
+- No sudo access required
+
+Example:
+```bash
+# Basic installation
+pnpx @gengjiawen/os-init set-android
+
+# Custom installation path
+pnpx @gengjiawen/os-init set-android --android-home ~/my-android-sdk
+
+# Skip environment variable configuration
+pnpx @gengjiawen/os-init set-android --skip-env-vars
+```
+
 ---
 
 Project generated by [gengjiawen/ts-scaffold](https://github.com/gengjiawen/ts-scaffold)

package/android-setup.md

@@ -0,0 +1,128 @@
+# Android Development Environment Setup
+
+This command sets up a complete Android development environment on macOS and Linux systems.
+
+## Usage
+
+```bash
+os-init set-android [options]
+```
+
+## What It Does
+
+The `set-android` command:
+
+1. **Creates Android SDK directory** at `~/Android` (or custom path)
+2. **Downloads and installs Android SDK** command-line tools (automatically detects macOS or Linux)
+3. **Accepts Android SDK licenses** automatically
+4. **Installs essential components**:
+   - Platform tools (adb, fastboot, etc.)
+   - Android 36 platform
+   - Build tools 36.0.0
+   - CMake 3.30.5
+   - NDK 29.0.14206865
+5. **Configures environment variables** in your shell configuration file (~/.bashrc, ~/.zshrc, or ~/.config/fish/config.fish)
+
+## Options
+
+- `--android-home <path>` - Custom Android SDK installation path (default: `~/Android`)
+- `--skip-env-vars` - Skip adding environment variables to shell config
+
+## Examples
+
+### Basic Installation
+
+```bash
+os-init set-android
+```
+
+This installs the Android SDK to `~/Android` and adds environment variables to your shell config.
+
+### Custom Installation Path
+
+```bash
+os-init set-android --android-home /home/user/android-sdk
+```
+
+### Skip Environment Variables
+
+If you prefer to manage environment variables manually:
+
+```bash
+os-init set-android --skip-env-vars
+```
+
+## Requirements
+
+- **macOS or Linux operating system**
+- Internet connection to download Android SDK
+- Node.js 22.12.0 or higher
+
+The script uses `@compilets/unzip-url` package to download and extract the Android SDK, so no external `curl` or `unzip` tools are required. No sudo access is needed as the SDK is installed in your home directory.
+
+## Environment Variables
+
+After installation, the following environment variables will be set:
+
+```bash
+export ANDROID_HOME=~/Android
+export ANDROID_SDK_ROOT=${ANDROID_HOME}
+export ANDROID_NDK_HOME=${ANDROID_HOME}/ndk/29.0.14206865
+export PATH=${ANDROID_HOME}/cmdline-tools/latest/bin:${ANDROID_HOME}/emulator:${ANDROID_HOME}/platform-tools:${ANDROID_HOME}/tools:${ANDROID_HOME}/tools/bin:${PATH}
+```
+
+## Activating the Environment
+
+After installation, activate the environment in your current shell:
+
+```bash
+source ~/.bashrc  # or ~/.zshrc, or ~/.config/fish/config.fish
+```
+
+Or simply open a new terminal session.
+
+## Verifying Installation
+
+Check that the Android SDK is properly installed:
+
+```bash
+adb --version
+sdkmanager --list
+```
+
+## Platform-Specific Notes
+
+### macOS
+- The SDK is downloaded from Google's macOS-specific distribution
+- Works on both Intel and Apple Silicon Macs
+- No sudo permissions required
+
+### Linux
+- The SDK is downloaded from Google's Linux-specific distribution
+- Tested on Ubuntu and Debian-based systems
+- No sudo permissions required when installing to home directory
+
+## Troubleshooting
+
+### Command Not Found After Installation
+
+Make sure you've sourced your shell configuration file or opened a new terminal:
+
+```bash
+source ~/.bashrc  # or your shell's config file
+```
+
+### Download Failures
+
+If the Android SDK download fails, check your internet connection and try again. The script will show detailed error messages.
+
+## What Gets Installed
+
+- **Android SDK Command-line Tools** (version 11076708)
+- **Platform Tools** - adb, fastboot, etc.
+- **Android Platform 36** - Latest Android API level
+- **Build Tools 36.0.0** - Tools for building Android apps
+- **CMake 3.30.5** - For native code compilation
+- **NDK 29.0.14206865** - Native Development Kit for C/C++ code
+
+

package/bin/bin.js

@@ -8,6 +8,7 @@ const {
   installCodexDeps,
   writeRaycastConfig,
   setupDevEnvironment,
+  setupAndroidEnvironment,
 } = require('../build')
 
 const program = new Command()
@@ -102,4 +103,29 @@ program
     }
   })
 
+program
+  .command('set-android')
+  .description('setup Android development environment (macOS and Linux)')
+  .option('--android-home <path>', 'Custom Android SDK installation path')
+  .option(
+    '--skip-env-vars',
+    'Skip adding environment variables to shell config'
+  )
+  .action(async (options) => {
+    try {
+      const { androidHome, envVarsAdded, shellRcFile } =
+        await setupAndroidEnvironment({
+          androidHome: options.androidHome,
+          skipEnvVars: options.skipEnvVars,
+        })
+      console.log(`\n✅ Android SDK installed at: ${androidHome}`)
+      if (envVarsAdded && shellRcFile) {
+        console.log(`✅ Environment variables added to: ${shellRcFile}`)
+      }
+    } catch (err) {
+      console.error('Failed to setup Android environment:', err.message)
+      process.exit(1)
+    }
+  })
+
 program.parse(process.argv)

package/build/android-setup.d.ts

@@ -0,0 +1,8 @@
+export declare function setupAndroidEnvironment(options?: {
+    androidHome?: string;
+    skipEnvVars?: boolean;
+}): Promise<{
+    androidHome: string;
+    envVarsAdded: boolean;
+    shellRcFile?: string;
+}>;

package/build/android-setup.js

@@ -0,0 +1,175 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.setupAndroidEnvironment = setupAndroidEnvironment;
+const fs = require("fs");
+const path = require("path");
+const os = require("os");
+const execa_1 = require("execa");
+const unzip_url_1 = require("@compilets/unzip-url");
+const ANDROID_CONFIG = {
+    sdkVersion: '11076708',
+    platformVersion: 'android-36',
+    buildToolsVersion: '36.0.0',
+    cmakeVersion: '3.30.5',
+    ndkVersion: '29.0.14206865',
+};
+function getDefaultAndroidHome() {
+    return path.join(os.homedir(), 'Android');
+}
+function getSdkDownloadUrl(sdkVersion) {
+    const platform = os.platform();
+    if (platform === 'darwin') {
+        return `https://dl.google.com/android/repository/commandlinetools-mac-${sdkVersion}_latest.zip`;
+    }
+    else if (platform === 'linux') {
+        return `https://dl.google.com/android/repository/commandlinetools-linux-${sdkVersion}_latest.zip`;
+    }
+    else {
+        throw new Error(`Unsupported platform: ${platform}. Only macOS and Linux are supported.`);
+    }
+}
+function getAndroidEnvVars(androidHome, ndkVersion) {
+    return `
+# Android development environment
+export ANDROID_HOME=${androidHome}
+export ANDROID_SDK_ROOT=\${ANDROID_HOME}
+export ANDROID_NDK_HOME=\${ANDROID_HOME}/ndk/${ndkVersion}
+export PATH=\${ANDROID_HOME}/cmdline-tools/latest/bin:\${ANDROID_HOME}/emulator:\${ANDROID_HOME}/platform-tools:\${ANDROID_HOME}/tools:\${ANDROID_HOME}/tools/bin:\${PATH}
+`;
+}
+function getShellRcFile() {
+    const shell = process.env.SHELL || '';
+    const homeDir = os.homedir();
+    if (shell.includes('zsh')) {
+        return path.join(homeDir, '.zshrc');
+    }
+    else if (shell.includes('fish')) {
+        return path.join(homeDir, '.config', 'fish', 'config.fish');
+    }
+    else {
+        return path.join(homeDir, '.bashrc');
+    }
+}
+function hasAndroidEnvVars(rcFile) {
+    if (!fs.existsSync(rcFile)) {
+        return false;
+    }
+    const content = fs.readFileSync(rcFile, 'utf-8');
+    return content.includes('ANDROID_HOME');
+}
+function appendEnvVarsToShellConfig(rcFile, envVars) {
+    const dir = path.dirname(rcFile);
+    if (!fs.existsSync(dir)) {
+        fs.mkdirSync(dir, { recursive: true });
+    }
+    fs.appendFileSync(rcFile, envVars);
+    console.log(`Environment variables added to: ${rcFile}`);
+}
+async function setupAndroidEnvironment(options) {
+    const androidHome = options?.androidHome || getDefaultAndroidHome();
+    const { sdkVersion, platformVersion, buildToolsVersion, cmakeVersion, ndkVersion, } = ANDROID_CONFIG;
+    console.log('Starting Android development environment setup...\n');
+    const platform = os.platform();
+    if (platform !== 'linux' && platform !== 'darwin') {
+        throw new Error(`Unsupported platform: ${platform}. Only macOS and Linux are supported.`);
+    }
+    console.log(`Platform: ${platform === 'darwin' ? 'macOS' : 'Linux'}`);
+    console.log(`Creating Android SDK directory at: ${androidHome}`);
+    try {
+        if (!fs.existsSync(androidHome)) {
+            fs.mkdirSync(androidHome, { recursive: true });
+        }
+    }
+    catch (error) {
+        throw new Error(`Failed to create Android directory: ${error instanceof Error ? error.message : String(error)}`);
+    }
+    console.log('\nDownloading and setting up Android SDK...');
+    const sdkUrl = getSdkDownloadUrl(sdkVersion);
+    try {
+        const cmdlineToolsPath = path.join(androidHome, 'cmdline-tools');
+        if (!fs.existsSync(cmdlineToolsPath)) {
+            fs.mkdirSync(cmdlineToolsPath, { recursive: true });
+        }
+        console.log(`Downloading and extracting from: ${sdkUrl}`);
+        await (0, unzip_url_1.unzip)(sdkUrl, cmdlineToolsPath);
+        const tempToolsPath = path.join(cmdlineToolsPath, 'cmdline-tools');
+        const latestToolsPath = path.join(cmdlineToolsPath, 'latest');
+        if (fs.existsSync(tempToolsPath)) {
+            fs.renameSync(tempToolsPath, latestToolsPath);
+        }
+        console.log('Android SDK extracted successfully');
+    }
+    catch (error) {
+        throw new Error(`Failed to download/extract Android SDK: ${error instanceof Error ? error.message : String(error)}`);
+    }
+    const sdkmanagerEnv = {
+        ...process.env,
+        ANDROID_HOME: androidHome,
+        ANDROID_SDK_ROOT: androidHome,
+        PATH: `${androidHome}/cmdline-tools/latest/bin:${process.env.PATH}`,
+    };
+    console.log('\nAccepting Android SDK licenses...');
+    try {
+        await (0, execa_1.execa)('bash', ['-c', 'yes | sdkmanager --licenses'], {
+            env: sdkmanagerEnv,
+            stdio: 'inherit',
+        });
+    }
+    catch (error) {
+        console.warn('Warning: License acceptance may have failed, but continuing...');
+    }
+    console.log('\nInstalling Android SDK components...');
+    const components = [
+        'platform-tools',
+        `platforms;${platformVersion}`,
+        `build-tools;${buildToolsVersion}`,
+        `cmake;${cmakeVersion}`,
+        `ndk;${ndkVersion}`,
+    ];
+    try {
+        const componentsList = components.join(' ');
+        await (0, execa_1.execa)('bash', ['-c', `yes | sdkmanager ${componentsList}`], {
+            env: sdkmanagerEnv,
+            stdio: 'inherit',
+        });
+        console.log('Android SDK components installed successfully');
+    }
+    catch (error) {
+        throw new Error(`Failed to install SDK components: ${error instanceof Error ? error.message : String(error)}`);
+    }
+    const androidConfigDir = path.join(androidHome, '.android');
+    if (fs.existsSync(androidConfigDir)) {
+        fs.rmSync(androidConfigDir, { recursive: true, force: true });
+    }
+    if (platform === 'linux' && androidHome.startsWith('/opt')) {
+        try {
+            await (0, execa_1.execa)('chmod', ['-R', '777', androidHome], { stdio: 'inherit' });
+        }
+        catch (error) {
+            console.warn('Warning: Failed to set permissions, but continuing...');
+        }
+    }
+    console.log('\n✅ Android SDK installation completed!');
+    let envVarsAdded = false;
+    let shellRcFile;
+    if (!options?.skipEnvVars) {
+        shellRcFile = getShellRcFile();
+        console.log(`\nConfiguring shell environment in: ${shellRcFile}`);
+        if (hasAndroidEnvVars(shellRcFile)) {
+            console.log('Android environment variables already exist in shell config, skipping...');
+        }
+        else {
+            const envVars = getAndroidEnvVars(androidHome, ndkVersion);
+            appendEnvVarsToShellConfig(shellRcFile, envVars);
+            envVarsAdded = true;
+        }
+        console.log('\n📋 To activate the environment in your current shell, run:');
+        console.log(`  source ${shellRcFile}`);
+    }
+    console.log('\n✅ Android development environment setup completed successfully!');
+    return {
+        androidHome,
+        envVarsAdded,
+        shellRcFile,
+    };
+}

package/build/dev-setup.js

@@ -43,15 +43,15 @@ async function setupDevEnvironment(sshPublicKey, targetDir) {
     }
     console.log(`Copying dev-setup to: ${targetPath}`);
     copyDirSync(sourceDir, targetPath);
-    const dockerfilePath = path.join(targetPath, 'Dockerfile.txt');
+    const dockerfilePath = path.join(targetPath, 'Dockerfile');
     if (fs.existsSync(dockerfilePath)) {
         let content = fs.readFileSync(dockerfilePath, 'utf-8');
         content = content.replace('ssh-public-key-placeholder', sshPublicKey);
         fs.writeFileSync(dockerfilePath, content);
-        console.log('SSH public key has been configured in Dockerfile.txt');
+        console.log('SSH public key has been configured in Dockerfile');
     }
     else {
-        throw new Error(`Dockerfile.txt not found in ${targetPath}`);
+        throw new Error(`Dockerfile not found in ${targetPath}`);
     }
     const hasDockerCompose = await commandExists('docker-compose');
     if (hasDockerCompose) {
@@ -84,7 +84,7 @@ async function setupDevEnvironment(sshPublicKey, targetDir) {
         console.log('  docker-compose build && docker-compose up -d');
     }
     const localIp = ip.address();
-    console.log('\n📡 SSH Connection:');
+    console.log('\n SSH Connection:');
     console.log(`  ssh gitpod@${localIp} -p 2222`);
     console.log('\nOr use localhost if connecting from the same machine:');
     console.log('  ssh gitpod@localhost -p 2222');

package/build/index.d.ts

@@ -12,3 +12,4 @@ export declare function writeRaycastConfig(apiKey: string): {
     configPath: string;
 };
 export { setupDevEnvironment } from './dev-setup';
+export { setupAndroidEnvironment } from './android-setup';

package/build/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.setupDevEnvironment = void 0;
+exports.setupAndroidEnvironment = exports.setupDevEnvironment = void 0;
 exports.writeClaudeConfig = writeClaudeConfig;
 exports.installDeps = installDeps;
 exports.writeCodexConfig = writeCodexConfig;
@@ -165,3 +165,5 @@ function writeRaycastConfig(apiKey) {
 }
 var dev_setup_1 = require("./dev-setup");
 Object.defineProperty(exports, "setupDevEnvironment", { enumerable: true, get: function () { return dev_setup_1.setupDevEnvironment; } });
+var android_setup_1 = require("./android-setup");
+Object.defineProperty(exports, "setupAndroidEnvironment", { enumerable: true, get: function () { return android_setup_1.setupAndroidEnvironment; } });

package/dev-setup/{Dockerfile.txt → Dockerfile}

@@ -15,5 +15,6 @@ RUN set -eux; \
 
 # Run sshd in foreground
 USER root
-EXPOSE 22
+EXPOSE 22 3000 5173
 CMD ["/usr/sbin/sshd", "-D", "-e"]
+

package/dev-setup/docker-compose.yml

@@ -8,8 +8,9 @@ services:
     tty: true
     ports:
       - '2222:22'
+      - '3000:3000'
+      - '5173:5173'
     cap_add:
       - SYS_PTRACE
     volumes:
       - .:/pwd
-      - $HOME/.local:/root/.local

package/dev-setup/{sshd_config.txt → sshd_config}

@@ -29,3 +29,4 @@ AcceptEnv LANG LC_*
 
 # SFTP Subsystem
 Subsystem sftp /usr/lib/openssh/sftp-server
+

package/libs/android-setup.ts

@@ -0,0 +1,243 @@
+import * as fs from 'fs'
+import * as path from 'path'
+import * as os from 'os'
+import { execa } from 'execa'
+import { unzip } from '@compilets/unzip-url'
+
+/** Android SDK configuration */
+const ANDROID_CONFIG = {
+  sdkVersion: '11076708',
+  platformVersion: 'android-36',
+  buildToolsVersion: '36.0.0',
+  cmakeVersion: '3.30.5',
+  ndkVersion: '29.0.14206865',
+} as const
+
+/** Get default Android home directory */
+function getDefaultAndroidHome(): string {
+  return path.join(os.homedir(), 'Android')
+}
+
+/** Get SDK download URL based on platform */
+function getSdkDownloadUrl(sdkVersion: string): string {
+  const platform = os.platform()
+  if (platform === 'darwin') {
+    return `https://dl.google.com/android/repository/commandlinetools-mac-${sdkVersion}_latest.zip`
+  } else if (platform === 'linux') {
+    return `https://dl.google.com/android/repository/commandlinetools-linux-${sdkVersion}_latest.zip`
+  } else {
+    throw new Error(
+      `Unsupported platform: ${platform}. Only macOS and Linux are supported.`
+    )
+  }
+}
+
+/** Get Android environment variables */
+function getAndroidEnvVars(androidHome: string, ndkVersion: string): string {
+  return `
+# Android development environment
+export ANDROID_HOME=${androidHome}
+export ANDROID_SDK_ROOT=\${ANDROID_HOME}
+export ANDROID_NDK_HOME=\${ANDROID_HOME}/ndk/${ndkVersion}
+export PATH=\${ANDROID_HOME}/cmdline-tools/latest/bin:\${ANDROID_HOME}/emulator:\${ANDROID_HOME}/platform-tools:\${ANDROID_HOME}/tools:\${ANDROID_HOME}/tools/bin:\${PATH}
+`
+}
+
+/** Detect shell configuration file */
+function getShellRcFile(): string {
+  const shell = process.env.SHELL || ''
+  const homeDir = os.homedir()
+
+  if (shell.includes('zsh')) {
+    return path.join(homeDir, '.zshrc')
+  } else if (shell.includes('fish')) {
+    return path.join(homeDir, '.config', 'fish', 'config.fish')
+  } else {
+    return path.join(homeDir, '.bashrc')
+  }
+}
+
+/** Check if Android environment variables already exist in shell config */
+function hasAndroidEnvVars(rcFile: string): boolean {
+  if (!fs.existsSync(rcFile)) {
+    return false
+  }
+  const content = fs.readFileSync(rcFile, 'utf-8')
+  return content.includes('ANDROID_HOME')
+}
+
+/** Append Android environment variables to shell config */
+function appendEnvVarsToShellConfig(rcFile: string, envVars: string): void {
+  const dir = path.dirname(rcFile)
+  if (!fs.existsSync(dir)) {
+    fs.mkdirSync(dir, { recursive: true })
+  }
+
+  fs.appendFileSync(rcFile, envVars)
+  console.log(`Environment variables added to: ${rcFile}`)
+}
+
+/** Setup Android development environment */
+export async function setupAndroidEnvironment(options?: {
+  androidHome?: string
+  skipEnvVars?: boolean
+}): Promise<{
+  androidHome: string
+  envVarsAdded: boolean
+  shellRcFile?: string
+}> {
+  const androidHome = options?.androidHome || getDefaultAndroidHome()
+  const {
+    sdkVersion,
+    platformVersion,
+    buildToolsVersion,
+    cmakeVersion,
+    ndkVersion,
+  } = ANDROID_CONFIG
+
+  console.log('Starting Android development environment setup...\n')
+
+  // Check if running on supported platform
+  const platform = os.platform()
+  if (platform !== 'linux' && platform !== 'darwin') {
+    throw new Error(
+      `Unsupported platform: ${platform}. Only macOS and Linux are supported.`
+    )
+  }
+
+  console.log(`Platform: ${platform === 'darwin' ? 'macOS' : 'Linux'}`)
+
+  // Create Android directory
+  console.log(`Creating Android SDK directory at: ${androidHome}`)
+  try {
+    if (!fs.existsSync(androidHome)) {
+      fs.mkdirSync(androidHome, { recursive: true })
+    }
+  } catch (error) {
+    throw new Error(
+      `Failed to create Android directory: ${error instanceof Error ? error.message : String(error)}`
+    )
+  }
+
+  // Download and setup Android SDK
+  console.log('\nDownloading and setting up Android SDK...')
+  const sdkUrl = getSdkDownloadUrl(sdkVersion)
+
+  try {
+    // Create cmdline-tools directory
+    const cmdlineToolsPath = path.join(androidHome, 'cmdline-tools')
+    if (!fs.existsSync(cmdlineToolsPath)) {
+      fs.mkdirSync(cmdlineToolsPath, { recursive: true })
+    }
+
+    // Download and extract SDK using unzip-url
+    console.log(`Downloading and extracting from: ${sdkUrl}`)
+    await unzip(sdkUrl, cmdlineToolsPath)
+
+    // Move cmdline-tools to latest
+    const tempToolsPath = path.join(cmdlineToolsPath, 'cmdline-tools')
+    const latestToolsPath = path.join(cmdlineToolsPath, 'latest')
+    if (fs.existsSync(tempToolsPath)) {
+      fs.renameSync(tempToolsPath, latestToolsPath)
+    }
+
+    console.log('Android SDK extracted successfully')
+  } catch (error) {
+    throw new Error(
+      `Failed to download/extract Android SDK: ${error instanceof Error ? error.message : String(error)}`
+    )
+  }
+
+  // Set environment variables for sdkmanager
+  const sdkmanagerEnv = {
+    ...process.env,
+    ANDROID_HOME: androidHome,
+    ANDROID_SDK_ROOT: androidHome,
+    PATH: `${androidHome}/cmdline-tools/latest/bin:${process.env.PATH}`,
+  }
+
+  // Accept licenses
+  console.log('\nAccepting Android SDK licenses...')
+  try {
+    await execa('bash', ['-c', 'yes | sdkmanager --licenses'], {
+      env: sdkmanagerEnv,
+      stdio: 'inherit',
+    })
+  } catch (error) {
+    console.warn(
+      'Warning: License acceptance may have failed, but continuing...'
+    )
+  }
+
+  // Install SDK components
+  console.log('\nInstalling Android SDK components...')
+  const components = [
+    'platform-tools',
+    `platforms;${platformVersion}`,
+    `build-tools;${buildToolsVersion}`,
+    `cmake;${cmakeVersion}`,
+    `ndk;${ndkVersion}`,
+  ]
+
+  try {
+    const componentsList = components.join(' ')
+    await execa('bash', ['-c', `yes | sdkmanager ${componentsList}`], {
+      env: sdkmanagerEnv,
+      stdio: 'inherit',
+    })
+    console.log('Android SDK components installed successfully')
+  } catch (error) {
+    throw new Error(
+      `Failed to install SDK components: ${error instanceof Error ? error.message : String(error)}`
+    )
+  }
+
+  // Clean up .android directory
+  const androidConfigDir = path.join(androidHome, '.android')
+  if (fs.existsSync(androidConfigDir)) {
+    fs.rmSync(androidConfigDir, { recursive: true, force: true })
+  }
+
+  // Set permissions (only needed on Linux for system-wide installs)
+  if (platform === 'linux' && androidHome.startsWith('/opt')) {
+    try {
+      await execa('chmod', ['-R', '777', androidHome], { stdio: 'inherit' })
+    } catch (error) {
+      console.warn('Warning: Failed to set permissions, but continuing...')
+    }
+  }
+
+  console.log('\n✅ Android SDK installation completed!')
+
+  // Handle environment variables
+  let envVarsAdded = false
+  let shellRcFile: string | undefined
+
+  if (!options?.skipEnvVars) {
+    shellRcFile = getShellRcFile()
+    console.log(`\nConfiguring shell environment in: ${shellRcFile}`)
+
+    if (hasAndroidEnvVars(shellRcFile)) {
+      console.log(
+        'Android environment variables already exist in shell config, skipping...'
+      )
+    } else {
+      const envVars = getAndroidEnvVars(androidHome, ndkVersion)
+      appendEnvVarsToShellConfig(shellRcFile, envVars)
+      envVarsAdded = true
+    }
+
+    console.log('\n📋 To activate the environment in your current shell, run:')
+    console.log(`  source ${shellRcFile}`)
+  }
+
+  console.log(
+    '\n✅ Android development environment setup completed successfully!'
+  )
+
+  return {
+    androidHome,
+    envVarsAdded,
+    shellRcFile,
+  }
+}

package/libs/dev-setup.ts

@@ -57,15 +57,15 @@ export async function setupDevEnvironment(
   console.log(`Copying dev-setup to: ${targetPath}`)
   copyDirSync(sourceDir, targetPath)
 
-  // Replace SSH_PUBLIC_KEY placeholder in Dockerfile.txt
-  const dockerfilePath = path.join(targetPath, 'Dockerfile.txt')
+  // Replace SSH_PUBLIC_KEY placeholder in Dockerfile
+  const dockerfilePath = path.join(targetPath, 'Dockerfile')
   if (fs.existsSync(dockerfilePath)) {
     let content = fs.readFileSync(dockerfilePath, 'utf-8')
     content = content.replace('ssh-public-key-placeholder', sshPublicKey)
     fs.writeFileSync(dockerfilePath, content)
-    console.log('SSH public key has been configured in Dockerfile.txt')
+    console.log('SSH public key has been configured in Dockerfile')
   } else {
-    throw new Error(`Dockerfile.txt not found in ${targetPath}`)
+    throw new Error(`Dockerfile not found in ${targetPath}`)
   }
 
   // Check if docker-compose is available
@@ -109,7 +109,7 @@ export async function setupDevEnvironment(
 
   // Display SSH connection instructions
   const localIp = ip.address()
-  console.log('\n📡 SSH Connection:')
+  console.log('\n SSH Connection:')
   console.log(`  ssh gitpod@${localIp} -p 2222`)
   console.log('\nOr use localhost if connecting from the same machine:')
   console.log('  ssh gitpod@localhost -p 2222')

package/libs/index.ts

@@ -210,3 +210,6 @@ export function writeRaycastConfig(apiKey: string): { configPath: string } {
 
 // Re-export dev-setup functionality
 export { setupDevEnvironment } from './dev-setup'
+
+// Re-export android-setup functionality
+export { setupAndroidEnvironment } from './android-setup'

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@gengjiawen/os-init",
   "private": false,
-  "version": "1.5.1",
+  "version": "1.7.0",
   "description": "",
   "main": "index.js",
   "bin": {
@@ -10,7 +10,7 @@
   "scripts": {
     "dev": "tsc -w",
     "server": "nodemon --exec ts-node libs/index.ts",
-    "prepare": "husky install",
+    "prepare": "husky",
     "clean": "rimraf build",
     "format": "prettier --write \"{examples,libs,script,bin}/**/*.{js,ts}\" \"**/*.yml\"",
     "format:check": "prettier --list-different \"{examples,libs,script,bin}/**/*.{js,ts}\" \"**/*.yml\"",
@@ -19,6 +19,7 @@
     "postbuild": "cpy '**/*' '!**/*.ts' ../build/ --cwd=libs --parents"
   },
   "dependencies": {
+    "@compilets/unzip-url": "^1.0.0",
     "commander": "^12.1.0",
     "ip": "^2.0.1",
     "execa": "^8.0.1"