sdkmanager

sdkmanager เป็นเครื่องมือบรรทัดคำสั่งที่ช่วยให้คุณดู ติดตั้ง อัปเดต และถอนการติดตั้งแพ็กเกจสำหรับ Android SDK ได้ หากใช้ Android Studio คุณไม่จำเป็นต้องใช้เครื่องมือนี้ แต่สามารถจัดการแพ็กเกจ SDK จาก IDE แทนได้

เครื่องมือ sdkmanager มีให้ใช้งานในแพ็กเกจเครื่องมือบรรทัดคำสั่งของ Android SDK หากต้องการใช้ SDK Manager เพื่อติดตั้งเครื่องมือบรรทัดคำสั่งเวอร์ชันใดเวอร์ชันหนึ่ง ให้ทำตามขั้นตอนต่อไปนี้

  1. ดาวน์โหลดแพ็กเกจเครื่องมือบรรทัดคำสั่งล่าสุดจากหน้า Android Studio แล้วแตกไฟล์แพ็กเกจ
  2. ย้ายไดเรกทอรี cmdline-tools ที่ไม่ได้ซิปไปยังไดเรกทอรีใหม่ ที่คุณเลือก เช่น android_sdk ไดเรกทอรีใหม่นี้คือ ไดเรกทอรี Android SDK
  3. ในไดเรกทอรี cmdline-tools ที่ไม่ได้ซิป ให้สร้าง ไดเรกทอรีย่อยชื่อ latest
  4. ย้ายเนื้อหาไดเรกทอรี cmdline-tools ต้นฉบับ ซึ่งรวมถึง ไดเรกทอรี lib, ไดเรกทอรี bin, ไฟล์ NOTICE.txt และไฟล์ source.properties ไปยัง ไดเรกทอรี latest ที่สร้างขึ้นใหม่ ตอนนี้คุณใช้เครื่องมือบรรทัดคำสั่ง จากตำแหน่งนี้ได้แล้ว
  5. (ไม่บังคับ) หากต้องการติดตั้งเครื่องมือบรรทัดคำสั่งเวอร์ชันก่อนหน้า ให้เรียกใช้คำสั่งต่อไปนี้

    android_sdk/cmdline-tools/latest/bin/sdkmanager --install "cmdline-tools;version"
    
    แทนที่ version ด้วยเวอร์ชันที่ต้องการติดตั้ง เช่น 5.0

การใช้งาน

คุณใช้ sdkmanager เพื่อแสดงรายการแพ็กเกจที่ติดตั้งและพร้อมใช้งาน ติดตั้ง แพ็กเกจ และอัปเดตแพ็กเกจได้ ดูรายละเอียดเพิ่มเติมได้ที่ส่วนต่อไปนี้

แสดงรายการแพ็กเกจที่ติดตั้งและพร้อมใช้งาน

หากต้องการแสดงรายการแพ็กเกจที่ติดตั้งและพร้อมใช้งาน ให้ใช้ไวยากรณ์ต่อไปนี้

sdkmanager --list [options] \
           [--channel=channel_id] // Channels: 0 (stable), 1 (beta), 2 (dev), or 3 (canary)

ใช้ตัวเลือก channel เพื่อรวมแพ็กเกจจากช่องจนถึงและรวมถึง channel_id เช่น ระบุแชแนล Canary เพื่อแสดงรายการ แพ็กเกจจากทุกแชแนล

ติดตั้งแพ็กเกจ

หากต้องการติดตั้งแพ็กเกจ ให้ใช้ไวยากรณ์ต่อไปนี้

sdkmanager packages [options]

อาร์กิวเมนต์ packages คือเส้นทางรูปแบบ SDK ดังที่แสดงด้วยคำสั่ง --list ซึ่งอยู่ในเครื่องหมายคำพูด เช่น "build-tools;35.0.0" หรือ "platforms;android-33"

คุณส่งเส้นทางแพ็กเกจหลายรายการได้โดยคั่นด้วยการเว้นวรรค แต่ต้องใส่เครื่องหมายคำพูดครอบแต่ละรายการ เช่น วิธีติดตั้งเครื่องมือแพลตฟอร์มและ เครื่องมือ SDK เวอร์ชันล่าสุดสำหรับ API ระดับ 33 มีดังนี้

sdkmanager "platform-tools" "platforms;android-33"

หรือจะส่งไฟล์ข้อความที่ระบุแพ็กเกจทั้งหมดก็ได้

sdkmanager --package_file=package_file [options]

อาร์กิวเมนต์ package_file คือตำแหน่งของไฟล์ข้อความซึ่งแต่ละบรรทัดเป็นเส้นทางรูปแบบ SDK ของแพ็กเกจที่จะติดตั้ง (ไม่มีเครื่องหมายคำพูด)

หากต้องการถอนการติดตั้ง ให้เพิ่มแฟล็ก --uninstall

sdkmanager --uninstall packages [options]
sdkmanager --uninstall --package_file=package_file [options]

หากต้องการติดตั้ง CMake หรือ NDK ให้ใช้ไวยากรณ์ต่อไปนี้

sdkmanager --install
           ["ndk;major.minor.build[suffix]" | "cmake;major.minor.micro.build"]
           [--channel=channel_id] // NDK channels: 0 (stable), 1 (beta), or 3 (canary)

เช่น ใช้คำสั่งต่อไปนี้เพื่อติดตั้ง NDK เวอร์ชันที่ระบุ ไม่ว่าปัจจุบันจะอยู่ในช่องใด

sdkmanager --install "ndk;21.3.6528147" --channel=3 // Install the NDK from the canary channel (or below)
sdkmanager --install "cmake;10.24988404" // Install a specific version of CMake

อัปเดตแพ็กเกจที่ติดตั้งทั้งหมด

หากต้องการอัปเดตแพ็กเกจที่ติดตั้งทั้งหมด ให้ใช้ไวยากรณ์ต่อไปนี้

sdkmanager --update [options]

ยอมรับใบอนุญาต

คุณต้องยอมรับใบอนุญาตที่จำเป็นสำหรับแต่ละแพ็กเกจที่คุณติดตั้ง ขั้นตอนนี้จะเกิดขึ้นในขั้นตอนการติดตั้งเมื่อคุณติดตั้ง แพ็กเกจจากภายใน Android Studio

หากไม่ได้ติดตั้ง Android Studio หรือใช้สำหรับเซิร์ฟเวอร์ CI หรืออุปกรณ์ Linux อื่นๆ ที่ไม่มีส่วนหัวซึ่งไม่ได้ติดตั้ง GUI ให้ทำ ดังต่อไปนี้จากบรรทัดคำสั่ง

sdkmanager --licenses

ซึ่งจะแจ้งให้คุณยอมรับใบอนุญาตที่ยังไม่ได้ยอมรับ

ตัวเลือก

ตารางต่อไปนี้แสดงตัวเลือกที่มีสำหรับคำสั่งที่ระบุไว้ในส่วนก่อนหน้า

ตัวเลือก คำอธิบาย
--sdk_root=path ใช้เส้นทาง SDK ที่ระบุแทน SDK ที่มีเครื่องมือนี้
--channel=channel_id รวมแพ็กเกจในช่องจนถึง channel_id ช่องทางที่มีให้บริการ มีดังนี้

0 (เสถียร), 1 (เบต้า), 2 (Dev), และ 3 (Canary)

--include_obsolete รวมแพ็กเกจที่ล้าสมัยไว้ในข้อมูลแพ็กเกจหรือการอัปเดตแพ็กเกจ สำหรับใช้กับ --list และ --update เท่านั้น
--no_https บังคับให้การเชื่อมต่อทั้งหมดใช้ HTTP แทน HTTPS
--newer ใช้ --list เพื่อแสดงเฉพาะแพ็กเกจใหม่หรือแพ็กเกจที่อัปเดตได้
--verbose โหมดเอาต์พุตแบบละเอียด ระบบจะพิมพ์ข้อผิดพลาด คำเตือน และข้อความข้อมูล
--proxy={http | socks} เชื่อมต่อผ่านพร็อกซีของประเภทที่ระบุ ไม่ว่าจะเป็น http สำหรับ โปรโตคอลระดับสูง เช่น HTTP หรือ FTP หรือ socks สำหรับพร็อกซี SOCKS (V4 หรือ V5)
--proxy_host={IP_address | DNS_address} ที่อยู่ IP หรือ DNS ของพร็อกซีที่จะใช้
--proxy_port=port_number หมายเลขพอร์ตพร็อกซีที่จะเชื่อมต่อ