start-android
Start Android development with Emulator, dev server, and optional Poltergeist auto-rebuild
- License 许可
- MIT
- 最近更新
- 2026-11-12
- Stars
- ★ 1
- Forks
- 1
01 前言 Front Matter
- name
- start-android
- description
- Start Android development with Emulator, dev server, and optional Poltergeist auto-rebuild
- user-invocable
- true
03 SKILL.md 正文
/start-android - Start Android Development Environment in tmux
Start Android development with Emulator, dev server, and optional Poltergeist auto-rebuild.
Usage
/start-android # debug build, .env.development
/start-android staging # staging build, .env.staging
/start-android release # release build, .env.production
/start-android debug Pixel_7 # Specific emulator
Process
Step 1: Determine Build Variant
VARIANT=${1:-debug}
DEVICE=${2:-"Pixel_7_Pro"}
case $VARIANT in
debug)
ENV_FILE=".env.development"
BUILD_TYPE="Debug"
;;
staging)
ENV_FILE=".env.staging"
BUILD_TYPE="Staging"
;;
release|production)
ENV_FILE=".env.production"
BUILD_TYPE="Release"
;;
esac
[ ! -f "$ENV_FILE" ] && ENV_FILE=".env"
Step 2: Detect Project Type
detect_android_project() {
if [ -d "android" ] && [ -f "android/build.gradle" ]; then
[ -f "package.json" ] && grep -q "react-native" package.json && echo "react-native" && return
[ -f "capacitor.config.json" ] && echo "capacitor" && return
[ -f "pubspec.yaml" ] && echo "flutter" && return
echo "native"
else
echo "unknown"
fi
}
PROJECT_TYPE=$(detect_android_project)
[ ! -d "android" ] && echo "❌ android/ directory not found" && exit 1
Step 3: Install Dependencies
# Gradle wrapper
[ -f "android/gradlew" ] && chmod +x android/gradlew
# npm
if [ -f "package.json" ] && [ ! -d "node_modules" ]; then
npm install
fi
Step 4: Setup Android Emulator
! command -v adb &> /dev/null && echo "❌ adb not found. Is Android SDK installed?" && exit 1
! emulator -list-avds 2>/dev/null | grep -q "^${DEVICE}$" && echo "❌ Emulator '$DEVICE' not found" && emulator -list-avds && exit 1
RUNNING_EMULATOR=$(adb devices | grep "emulator" | cut -f1)
if [ -z "$RUNNING_EMULATOR" ]; then
emulator -avd "$DEVICE" -no-snapshot-load -no-boot-anim &
adb wait-for-device
sleep 5
while [ "$(adb shell getprop sys.boot_completed 2>/dev/null | tr -d '\r')" != "1" ]; do
sleep 2
done
fi
EMULATOR_SERIAL=$(adb devices | grep "emulator" | cut -f1 | head -1)
Step 5: Setup Port Forwarding
# For dev server access from emulator
if [ "$PROJECT_TYPE" = "react-native" ] || grep -q "\"dev\":" package.json 2>/dev/null; then
DEV_PORT=$(shuf -i 3000-9999 -n 1)
adb -s "$EMULATOR_SERIAL" reverse tcp:$DEV_PORT tcp:$DEV_PORT
fi
Step 6: Configure Poltergeist (Optional)
POLTERGEIST_AVAILABLE=false
if command -v poltergeist &> /dev/null; then
POLTERGEIST_AVAILABLE=true
[ ! -f ".poltergeist.yml" ] && cat > .poltergeist.yml <<EOF
platform: android
watchPaths:
- android/app/src/**/*.kt
- android/app/src/**/*.java
- android/app/src/**/*.xml
ignorePaths:
- android/app/build/**
- android/.gradle/**
buildCommand: |
cd android && ./gradlew assemble${BUILD_TYPE} && cd ..
installCommand: |
adb -s $EMULATOR_SERIAL install -r android/app/build/outputs/apk/${VARIANT}/app-${VARIANT}.apk
EOF
fi
Step 7: Create tmux Session
PROJECT_NAME=$(basename "$(pwd)")
BRANCH=$(git branch --show-current 2>/dev/null || echo "main")
TIMESTAMP=$(date +%s)
SESSION="android-${PROJECT_NAME}-${TIMESTAMP}"
tmux new-session -d -s "$SESSION" -n build
Step 8: Build & Install
case $PROJECT_TYPE in
react-native)
tmux send-keys -t "$SESSION:build" "npx react-native run-android --variant=$VARIANT --deviceId=$EMULATOR_SERIAL" C-m
;;
capacitor)
tmux send-keys -t "$SESSION:build" "npx cap sync android && npx cap run android --target=$EMULATOR_SERIAL" C-m
;;
flutter)
tmux send-keys -t "$SESSION:build" "flutter run -d $EMULATOR_SERIAL --flavor $VARIANT" C-m
;;
native)
tmux send-keys -t "$SESSION:build" "cd android && ./gradlew install${BUILD_TYPE} && cd .." C-m
;;
esac
Step 9: Setup Additional Windows
# Dev server (if needed)
if [ "$PROJECT_TYPE" = "react-native" ] || grep -q "\"dev\":" package.json 2>/dev/null; then
tmux new-window -t "$SESSION" -n dev-server
tmux send-keys -t "$SESSION:dev-server" "PORT=$DEV_PORT npm start 2>&1 | tee dev-server.log" C-m
fi
# Poltergeist (if available)
if [ "$POLTERGEIST_AVAILABLE" = true ]; then
tmux new-window -t "$SESSION" -n poltergeist
tmux send-keys -t "$SESSION:poltergeist" "poltergeist watch --platform android 2>&1 | tee poltergeist.log" C-m
fi
# Logs
tmux new-window -t "$SESSION" -n logs
tmux send-keys -t "$SESSION:logs" "adb -s $EMULATOR_SERIAL logcat -v color" C-m
# Git
tmux new-window -t "$SESSION" -n git
tmux send-keys -t "$SESSION:git" "git status" C-m
Step 10: Save Metadata
cat > .tmux-android-session.json <<EOF
{
"session": "$SESSION",
"project_name": "$PROJECT_NAME",
"branch": "$BRANCH",
"type": "$PROJECT_TYPE",
"variant": "$VARIANT",
"environment": "$ENV_FILE",
"emulator": {
"name": "$DEVICE",
"serial": "$EMULATOR_SERIAL"
},
"dev_port": ${DEV_PORT:-null},
"poltergeist": $POLTERGEIST_AVAILABLE,
"created": "$(date -Iseconds)"
}
EOF
Step 11: Display Summary
echo ""
echo "✨ Android Dev Environment Started: $SESSION"
echo ""
echo "Variant: $VARIANT ($ENV_FILE)"
echo "Emulator: $DEVICE ($EMULATOR_SERIAL)"
[ "$POLTERGEIST_AVAILABLE" = true ] && echo "Poltergeist: Auto-rebuild enabled"
echo ""
echo "Attach: tmux attach -t $SESSION"
echo "Status: /tmux-status"
echo ""
Notes
- Auto-detects: React Native, Capacitor, Flutter, Native Android
- Maps build variant to environment file
- Poltergeist enables auto-rebuild on file changes
- Port forwarding for emulator to access localhost dev server
- Session persists across disconnects
04 同仓库更多 Skills
well-formed
Fixture skill that satisfies every mechanical rule, used to prove the conformance check passes a clean tree instead of failing everything.
underscore-tools
Fixture skill that spells the tool allowlist key with an underscore instead of the hyphen the spec requires.
no-frontmatter
暂无简介
long-description
Fixture skill with a deliberately oversized description used to prove the conformance check rejects anything past the 1024 character ceiling. Fixture skill with a deliberately oversized description used to prove the conformance check rejects anything past the 1024 character ceiling. Fixture skill with a deliberately oversized description used to prove the conformance check rejects anything past the 1024 character ceiling. Fixture skill with a deliberately oversized description used to prove the conformance check rejects anything past the 1024 character ceiling. Fixture skill with a deliberately oversized description used to prove the conformance check rejects anything past the 1024 character ceiling. Fixture skill with a deliberately oversized description used to prove the conformance check rejects anything past the 1024 character ceiling. Fixture skill with a deliberately oversized description used to prove the conformance check rejects anything past the 1024 character ceiling. Fixture skill with a deliberately oversized description used to prove the conformance check rejects anything past the 1024 character ceiling. Fixture skill with a deliberately oversized description used to prove the conformance check rejects anything past the 1024 character ceiling. Fixture skill with a deliberately oversized description used to prove the conformance check rejects anything past the 1024 character ceiling. Fixture skill with a deliberately oversized description used to prove the conformance check rejects anything past the 1024 character ceiling. Fixture skill with a deliberately oversized description used to prove the conformance check rejects anything past the 1024 character ceiling.
some-other-name
Fixture skill whose frontmatter name does not match its parent directory name.
bad_Name
Fixture skill whose name uses an underscore and a capital letter, so it violates the agentskills.io name pattern.