SDK 플랫폼 도구 출시 노트

컬렉션을 사용해 정리하기 내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.

Android SDK 플랫폼 도구는 Android SDK의 구성요소입니다. 여기에는 Android 플랫폼과 연동되는 adb 및 fastboot 도구가 주로 포함되어 있습니다. Android 앱 개발에 adb가 필요하지만 앱 개발자는 일반적으로 스튜디오 설치 사본을 사용합니다. 이 다운로드는 명령줄에서 adb를 직접 사용하려는데 스튜디오가 설치되지 않은 경우에 유용합니다. 스튜디오를 설치한 경우 스튜디오에서 자동으로 업데이트되므로 설치된 사본을 사용할 수 있습니다. 기기 부트로더를 잠금 해제하고 새 시스템 이미지로 플래시하려면 fastboot가 필요합니다. 이 패키지는 이전에 systrace를 포함했지만, 이는 더 이상 사용되지 않으며 Studio Profiler, gpuinspector.dev 또는 Perfetto로 대체되었습니다.

adb 및 fastboot의 일부 새 기능은 최신 버전의 Android에서만 사용할 수 있지만 이러한 기능은 이전 버전과 호환되므로 최신 버전의 SDK 플랫폼 도구만 있으면 됩니다. 예외를 발견하면 버그를 신고해야 합니다.

다운로드

Android 개발자는 Android 스튜디오의 SDK Manager 또는 sdkmanager 명령줄 도구에서 최신 SDK 플랫폼 도구를 가져와야 합니다. 그래야만 도구가 나머지 Android SDK 도구와 함께 올바른 위치에 저장되고 쉽게 업데이트됩니다.

그러나 명령줄 도구만 필요한 경우 다음 링크를 사용하세요.

• Windows용 SDK 플랫폼 도구 다운로드
• Mac용 SDK 플랫폼 도구 다운로드
• Linux용 SDK 플랫폼 도구 다운로드

이러한 링크는 변경되지 않지만, 항상 최신 버전의 도구를 가리킵니다.

버전 기록

36.0.0 (2025년 4월)

• adb
  • libusb USB 백엔드를 다시 작성했습니다 (비동기 API 대신 동기화 API 사용). 안정성을 개선하고 Linux에서 메모리 부족 문제를 수정했습니다.
  • 이제 Libusb USB 백엔드 핫플러그가 Windows를 지원합니다 (USB 속도 감지가 사용 설정됨).
  • 이제 개선된 server-status에 mdns가 사용 설정되어 있는지 여부가 표시됩니다.
  • 길이가 0인 패킷이 전송되지 않아 연결이 중단되는 macOS 버그를 수정했습니다 (b/208675141).
  • libusb 백엔드에서 use-after-free가 수정되었습니다.

35.0.2 (2024년 7월)

• adb
  • 잘린 쿼리에서 서버를 다운시키는 openscreen mDNS 백엔드 버그를 수정했습니다. 문제 #294120933
  • macOS에서 openscreen mDNS 백엔드가 작동하도록 합니다.
  • 모든 플랫폼에서 openscreen mDNS 백엔드를 기본값으로 설정합니다.
  • 진단 목적으로 USB SuperSpeed+ (현재 속도 및 협상된 속도)를 감지하는 지원
  • 단계적 종료: 종료 시 모든 USB 인터페이스를 해제합니다 (모든 OS).

35.0.1 (2024년 3월)

• adb
  • libusb 1.0.27로 전환

35.0.0 (2024년 2월)

• adb
  • Linux에서 기본값으로 libusb로 전환합니다(문제 #270205252).
  • USB가 없는 호스트에서 adb 시작 문제를 수정했습니다.
  • USB 기기가 길이가 0인 설명자를 잘못 보고하여 발생하는 adb 중단 문제를 수정했습니다. 문제 #302212871
  • 기기 연결 해제 시 adb shell의 반환 코드를 수정했습니다. 문제 #321787891
• 빠른 부팅
  • 수신 패킷 큐의 최대 크기를 제한합니다.
  • 이전에 다운로드 속도를 약 120MB/s로 제한했던 병목 현상을 제거했습니다. 이제 빠른 부팅이 SuperSpeed+ 버스를 포화시키고 기기에 따라 최대 980MB/s의 속도를 달성할 수 있습니다.

34.0.5 (2023년 10월)

• adb
  • 이제 adb가 macOS에서 기본적으로 libusb를 사용하도록 설정되어 문제 #270205252를 해결합니다.
  • 이전에는 무선 페어링에 실패하면 adb가 성공 코드로 응답했습니다. 실패 코드 (1)와 사용자 대상 오류 (error: protocol fault (couldn't read status message...))를 반환하여 이 문제를 해결했습니다. 이제 echo $?가 1를 보고합니다.
  • 이제 adb wait-for-disconnect가 USB가 아닌 (무선 디버깅) 환경에서 작동합니다.
  • 향후 adb를 통한 ChromeOS 지원을 위해 새로운 DbC 인터페이스를 추가했습니다.
• 빠른 부팅
  • Pixel 3 기기의 flashall이 수정되었습니다.

34.0.4 (2023년 7월)

• adb
  • adb가 adb 호스트 서버를 포크할 때 -a (gListenAll)를 전파합니다(이전에는 이 플래그가 adb -a server nodaemon에만 작동함).
  • 더 빠른 루팅 및 루팅 해제
  • Flag(env) guarding clear endpoint (device) feature for OSX usb start.를 다시 로드합니다(문제 #270205252).
• 빠른 부팅
  • Mac: 잘못된 IO 반복자에 대한 재시도를 삭제합니다 (LIBUSB_TRANSFER_CANCELLED로 플래시 실패).
  • Windows: 'flashall'을 사용할 때 '스파스 파일이 너무 크거나 잘못됨'을 수정합니다.
  • 모든 플랫폼: '업데이트'를 사용할 때 'ANDROID_PRODUCT_OUT not set'을 수정합니다.

34.0.1(2023년 3월)

• adb
  • macOS: adb 설치 중단으로 인해 '불안정한 연결(MacBook 고속 케이블)' 문제 해결이 취소되었습니다. (문제 #270205252)
• 빠른 부팅
  • Windows: 플랫폼 도구 34.0.0에서 발생한 'mke2fs: 파일 시스템 크기를 확인하려고 할 때 잘못된 또는 잘못된 형식의 기기 이름' 오류가 수정되었습니다. (문제 #271039230)

34.0.0 RC2(2023년 3월)

• Android 14 개발자 프리뷰 2 버전으로 업데이트되었습니다 (adb 및 빠른 부팅은 업데이트되지 않음).

34.0.0(2023년 2월)

• adb
  • macOS에 길이가 0인 패킷이 전송(issuetracker: 208675141)되는 문제가 수정되었습니다.
  • 불안정한 연결(MacBook 고속 케이블): adb 연결이 자주 끊김 문제를 해결했습니다.
  • 인수 수가 부족한 adb push 관련 오류 메시지가 개선되었습니다.
• 빠른 부팅
  • 개선된 플래싱: 이제 flashall이 가능한 경우 재부팅을 사용자 공간으로 건너뜁니다.
  • macOS에 길이가 0인 패킷이 전송(issuetracker: 208675141)되는 문제가 수정되었습니다.
  • 플래싱 recovery.img로 인한 잘못된 AVB 바닥글이 수정되었습니다.

33.0.3(2022년 8월)

• adb
  • 첫 번째 시도가 실패하면 adb root를 다시 시도하지 마세요.
  • 트랙 기기 중복 항목을 수정합니다.
  • 수신 윈도잉(지연 시간이 긴 연결의 처리량 증가)을 추가합니다.
  • '2개 이상의 기기' 실패 사례에 표시되는 더 구체적인 오류 메시지입니다.
  • 예상치 못한 역방향 전달 요청을 거부합니다.
  • Windows에서 install-multi-package를 수정합니다.
• 빠른 부팅
  • SDK 플랫폼 도구의 일부로 e2fsdroid를 삭제합니다.
  • 성공 시 OemCmdHandler 반환 메시지를 출력합니다.

33.0.2(2022년 5월)

• 빠른 부팅
  • vendor_kernel_boot 파티션을 지원합니다.

33.0.1(2022년 3월)

• adb
  • Windows mdns 비정상 종료를 수정합니다.
  • 이전 기기에서의 enable-verity/disable-verity를 수정합니다.
  • 이전 기기에서의 '여러 버전 설치'를 수정합니다.
  • 지원되는 모든 압축 방법을 포함하도록 도움말 출력을 개선합니다.
• systrace
  • 삭제되었습니다. 대신 Studio Profiler/gpuinspector.dev/Perfetto를 사용합니다.

33.0.0(2022년 2월)

• adb
  • 인수 없이 실행할 때 32.0.0에서 발생하는 비정상 종료 문제를 해결합니다.

32.0.0(2022년 1월)

• adb
  • Apple M1 기기용 범용 바이너리입니다.
  • 알려진 문제: 인수 없이 실행할 때 이 버전이 다운됩니다.

31.0.3(2021년 8월)

• 빠른 부팅
  • fastboot flashall/update를 위한 vbmeta_vendor.img 플래시를 지원합니다.

31.0.2(2021년 4월)

• adb
  • Linux의 vsock으로 전달하는 기능을 지원합니다.
  • 기기가 무선 디버깅을 통해 즉시 업데이트를 수신하지 못하는 adb track-devices의 버그를 수정했습니다.
  • 별도로 설치된 mDNS 서비스를 사용하지 않고 mDNS 기기 검색을 위한 예비 지원을 구현합니다. 이 기능은 현재 기본적으로 사용 중지되어 있으며 adb 서버를 시작할 때 환경 변수 ADB_MDNS_OPENSCREEN을 1로 설정하여 사용 설정할 수 있습니다.
• 빠른 부팅
  • 부팅 파티션 크기를 가져올 수 없더라도 실패하지 않습니다.
  • 커널 명령줄을 파싱하지 않고 속성에서 기기 잠금 상태를 가져옵니다.

31.0.1(2021년 3월)

• adb
  • TCP 연결 유지 간격을 줄입니다.
  • 증분 설치 성능을 개선합니다.
• 빠른 부팅
  • 압축된 스냅샷 병합을 지원합니다.
  • 기존 A/B 지원을 복원합니다.

31.0.0(2021년 2월)

• adb
  • 기본적으로 pull에서 압축을 사용 중지합니다.

30.0.5(2020년 11월)

• adb
  • 지연 시간이 긴 연결을 통해 많은 파일을 푸시할 때 adb push의 성능을 향상합니다.
  • Windows에서 adb push/pull의 성능을 개선합니다.
  • 여러 입력으로 adb push --sync를 수정합니다.
  • 증분 APK 설치 성능을 개선합니다.
  • 증분 APK 설치에 관한 오류 처리를 개선합니다.

30.0.4(2020년 7월)

• adb
  • Android 11 이전의 기기에서 비증분 APK 설치의 대체 항목을 수정합니다.
  • adb install-multi-package를 수정합니다.
  • adb 무선 페어링과 관련된 일부 비정상 종료 문제를 수정합니다.
  • 일부 오류 메시지를 개선합니다.
• 빠른 부팅
  • fastboot oem 명령어의 콘솔 출력을 개선합니다.
  • Nexus 7과 같은 구형 기기의 fastboot flashall을 수정합니다.

30.0.3(2020년 6월)

• adb
  • Android 11 이전의 기기에서 v4 서명 체계로 서명된 APK를 설치할 때 발생하는 문제를 수정합니다.
  • ADB_VENDOR_KEYS 없이 인증할 때 발생하는 비정상 종료 문제를 수정합니다.
  • adb -H 사용 시 발생하는 비정상 종료 문제를 수정합니다.

30.0.2(2020년 6월)

• adb
  • adb 무선 페어링을 개선합니다.
  • 기기가 연결되기 전에 실행할 때 adb logcat에서 중단되는 문제를 수정합니다.
  • adb transport-id를 추가하여 root/unroot/reboot 사용 후 기기가 사라질 때까지 스크립트가 대기하도록 합니다.

30.0.1(2020년 5월)

• adb
  • 기본적으로 adb mdns 자동 연결을 사용 중지합니다. ADB_MDNS_AUTO_CONNECT 환경 변수로 다시 사용 설정할 수 있습니다.
  • Android 10 이상의 기기에서 adb install-multi의 성능을 개선합니다.
  • TCP를 통해 연결된 기기에서 adb root/unroot를 사용할 때 발생하는 시간 초과 문제를 수정합니다.
  • 무선 페어링에 관한 지원을 업데이트합니다.

30.0.0(2020년 4월)

• adb
  • 무선 페어링에 대한 초기 지원을 추가합니다.
  • 증분 APK 설치를 지원합니다.
  • Android 11 기기와 함께 사용할 때 adb {push, pull, sync} 압축을 위해 클라이언트 측 지원을 구현합니다.
  • 지연 시간이 긴 연결에서 adb push의 성능을 개선합니다.
  • Windows에서 push/pull 성능을 개선합니다.

29.0.6(2020년 2월)

• adb
  • Android 11 기기와 함께 사용할 때 adb ls를 위한 64비트 크기/시간 지원을 추가합니다.
  • POSIX에서 ::1 수신 대기를 지원합니다.
  • WinUSB 설명자를 게시하는 WinUSB 기기의 클라이언트 지원(Android 11에 필요)은 더 이상 USB 드라이버를 설치할 필요가 없습니다.
  • 실제로 파일이 아닌 항목에 adb install을 사용할 때 중단되던 문제를 수정했습니다.

29.0.5(2019년 10월)

• adb
  • 여러 동시 연결을 사용할 때 Linux에서 성능을 약간 개선합니다.
  • 개발하는 동안 APK의 증분 업데이트를 위해 adb install에 --fastdeploy 옵션을 추가합니다.

29.0.4(2019년 9월)

• adb
  • LLDB를 사용한 네이티브 디버깅 시간 초과를 위한 핫픽스(문제 #134613180 참고). idea.log 파일에서 볼 수 있는 AdbCommandRejectedException을 발생시키는 Android 스튜디오 프로파일러의 관련 버그도 수정합니다.

29.0.3(2019년 9월)

• adb
  • adb forward --list는 연결된 여러 기기와 호환됩니다.
  • Windows에서 기기가 오프라인으로 전환되는 문제를 해결합니다.
  • adb install 출력 및 도움말 텍스트를 개선합니다.
  • 포트를 지정하지 않고 adb connect <host>의 이전 동작을 복원합니다.

29.0.2(2019년 7월)

• adb
  • Windows 힙 무결성 장애를 수정합니다.
• 빠른 부팅
  • 출시 예정 기기의 파티션 레이아웃에 관한 지원을 추가합니다.

29.0.1(2019년 6월)

• adb
  • Windows 비정상 종료에 관한 핫픽스(https://issuetracker.google.com/134613180)

29.0.0(2019년 6월)

• adb
  • adb reconnect는 Linux에서 USB 재설정을 실행합니다.
  • Linux에서 최신 adb 서버에 연결되면, adb는 서버를 종료하고 이전 서버를 시작하는 대신 최신 버전을 투명하게 시작하려고 시도합니다.
  • adb root는 연결을 끊은 후 기기가 다시 연결될 때까지 기다립니다. 이전에는 adb가 기기 연결이 끊어졌음을 파악하기 전에 adb wait-for-device가 시작되면 adb root; adb wait-for-device가 실수로 즉시 반환될 수 있었습니다.
• 빠른 부팅
  • macOS에서 빠른 부팅이 터치 바 또는 키보드를 열려고 시도할 때 발생한 오류 메시지를 사용 중지합니다.

28.0.2(2019년 3월)

• adb
  • '동종 앱에 의한 연결 재설정' 오류 메시지로 이어지는 adb shell 포트 전달의 결함을 수정합니다.
  • 기기를 다시 연결할 때 ADB_VENDOR_KEYS를 통한 인증을 수정합니다.
  • 인증에 사용된 비공개 키가 공개 키와 일치하지 않는 경우 키가 일치한다고 가정하는 대신 비공개 키에서 공개 키를 계산하여 인증을 수정합니다.
• 빠른 부팅
  • 동적 파티션 지원 기능을 추가합니다.
• 업데이트된 Windows 요구사항
  • 플랫폼 도구는 이제 Windows 업데이트를 통해 기본적으로 설치되는 Windows Universal C Runtime에 의존합니다. 누락된 DLL과 관련된 오류가 발생하면 런타임 패키지를 수동으로 가져와서 설치해야 할 수 있습니다.

28.0.1(2018년 9월)

• adb
  • TCP 연결의 재연결 지원 기능을 추가합니다. 연결이 끊어지면 adb는 연결을 포기하기 전에 최대 60초 동안 재연결을 시도합니다.
  • Windows에서 유니코드 콘솔 출력을 수정합니다. (외부 참여자 스펜서 로우님 감사합니다.)
  • 발생할 수 있는 파일 설명자 이중 닫기를 수정합니다. 그 결과 adb connect가 동시에 발생할 때 연결이 닫힙니다.
  • 연결된 둘 이상의 기기에서 사용될 때 adb forward --list를 수정합니다.
• 빠른 부팅
  • 일부 느린 부트로더 명령어를 더 효과적으로 지원하기 위해 명령어 시간 초과를 30초로 늘립니다.

28.0.0(2018년 6월)

• adb:
  • Android P를 실행하는 기기에서 체크섬 없는 작업에 관한 지원을 추가합니다. 그 결과 처리량이 최대 40% 향상됩니다.
  • 연결 유형 및 기기 일련번호를 기준으로 adb devices의 출력을 정렬합니다.
  • 더 많은 동시 adb 명령어를 허용하도록 소켓 수신 백로그를 늘립니다.
  • adb connect의 오류 출력을 개선합니다.
• 빠른 부팅:
  • 출력 형식을 개선하고 상세 출력 모드(-v)를 추가합니다.
  • 도움말 출력을 정리합니다.
  • fastboot flashall로 플래시되는 파티션 목록에 product.img와 odm.img를 추가합니다.
  • 너무 오래된 버전의 빠른 부팅을 사용할 때 공장 출고 시 이미지 패키지에서 특정 파티션 지원 기능을 요구하게 하여 새 기기의 벽돌화(bricking)를 피합니다.

27.0.1(2017년 12월)

• adb: USB 3.0을 사용하여 기기를 연결할 때 발생하던 MacOS에서의 어설션 실패를 수정합니다.
• 빠른 부팅: Windows에서 F2FS(Flash-Friendly File System)를 사용하는 기기의 완전 삭제 지원을 추가합니다.

27.0.0(2017년 12월)

• 26.0.1에서 처음 수정되었지만 26.0.2에 다시 나타난 macOS 10.13 빠른 부팅 버그를 다시 수정합니다.

26.0.2(2017년 10월)

• Pixel 2 기기의 fastboot 지원을 추가합니다.

26.0.1(2017년 9월)

• macOS 10.13 High Sierra에서 빠른 부팅 문제가 수정되었습니다(버그 64292422).

26.0.0(2017년 6월)

• Android O 최종 SDK(API 수준 26)의 버전으로 업데이트되었습니다.

25.0.5(2017년 4월 24일)

• Windows에서 'std::bad_alloc'으로 나타나는 대규모 업데이트의 adb 사이드로드가 수정되었습니다(버그 37139736).

• '전송 등록 소켓 쌍을 열 수 없음'으로 나타나는 일부 Windows 방화벽의 adb 문제가 수정되었습니다(버그 37139725).

• 이제 adb --version과 fastboot --version에 모두 설치 경로가 포함됩니다.

• 잘못 구성된 VPN 문제를 해결하기 위해 localhost를 확인하지 못하도록 adb가 변경되었습니다.

• 연결된 다른 USB 기기에 영향을 줄 수 있으므로 Linux에서 USB 기기를 더 이상 재설정하지 않도록 adb가 변경되었습니다.

25.0.4(2017년 3월 16일)

• 실험 단계의 libusb 지원이 Linux 및 Mac adb에 추가되었습니다.

libusb 백엔드를 사용하려면 새 adb 서버를 시작하기 전에 환경 변수 ADB_LIBUSB=true를 설정하세요. 새로운 명령어인 adb host-features는 libusb를 사용 중인지 알려줍니다.

libusb로 adb를 다시 시작하고 작동하는지 확인하려면 adb kill-server; ADB_LIBUSB=1 adb start-server; adb host-features를 사용하세요. 출력에 'libusb'가 포함되어야 합니다.

이 버전에서는 이전의 비 libusb 구현이 기본값으로 유지됩니다.

• 빠른 부팅에서 더 이상 2016 MacBook Pros를 중단시키지 않습니다(버그 231129).

• Mac에서 Systrace 명령줄 캡처가 수정되었습니다.

25.0.3(2016년 12월 16일)

• Android Things 기기의 플래시 실패를 일으키는 fastboot 버그가 수정되었습니다.

25.0.2(2016년 12월 12일)

• Android N MR1 안정화 버전(API 25)으로 업데이트되었습니다.

25.0.1(2016년 11월 22일)

• Android N MR1 개발자 프리뷰 2 버전(API 25)으로 업데이트되었습니다.

25.0.0(2016년 10월 19일)

• Android N MR1 개발자 프리뷰 1 버전(API 25)으로 업데이트되었습니다.

24.0.4(2016년 10월 14일)

• ADB 및 Mac OS Sierra의 문제를 해결하도록 업데이트되었습니다.