이 페이지에서

For AI agents: a documentation index is available at /docs/llms.txt. Append .md to any page URL for markdown, or send Accept: text/markdown.

가이드 및 설문 조사 모바일 SDK 변경 내용

3.13.0

2026년 8월 21일 릴리즈. 플랫폼: Android, iOS, React Native.

기능

  • [iOS] [Android] 지원 "요소는 마커입니다" 툴팁 옵션(GSM-1123).

수정

  • [iOS] [Android] 가로 레이아웃은 미디어와 콘텐츠 간의 테마 간격을 사용합니다(GSM-1174).
  • [iOS] [Android] 고정 높이 카드 임베디드는 CTA를 맨 아래에 유지합니다(GSM-1173).
  • [iOS] 테마 줄 높이는 가이드 제목과 콘텐츠에 적용되며 편집기 미리 보기와 일치합니다(GSM-1192).
  • [Android] 등급 질문은 카드 삽입에 나타납니다(GSM-1204).

성능 향상

  • [iOS] refresh()는 이제 "비동기화" 상태이므로 메인 스레드를 방해하지 않습니다(GSM-1201).

3.12.1

2026년 8월 13일 릴리즈됨. 플랫폼: Android, iOS, React Native.

수정

  • [Android] 고유한 이름을 가진 FileProvider 하위 클래스를 선언하여, androidx.core.content.FileProvider를 선언하는 다른 종속성이 있는 앱에서 더 이상 매니페스트 병합이 실패하지 않도록 합니다 (GSM-1194).

3.12.0

2026년 7월 31일 릴리즈되었습니다. 플랫폼: Android, iOS, React Native.

기능

  • [Flutter] 릴리스는 이제 출시된 네이티브 SDK 버전에서 네이티브 iOS 및 Android SDK 핀을 자동으로 업데이트합니다.
  • [iOS] 및 [Android] 모바일에서 쇼케이스 및 분할 콘텐츠 레이아웃 지원(GSM-1126).
  • [Android] 카드 내장 폼 팩터 유형(GSM-1135)을 추가합니다.
  • [iOS] 카드 내장 폼 팩터 유형(GSM-1049)을 추가합니다.
  • [iOS] [Android] 링크 이미지에 대한 지원을 추가합니다(GSM-1144).
  • [iOS] 가이드 이미지가 로드되는 동안 위치 표시자 아이콘을 표시합니다(GSM-1120).
  • [React Native] 이제 boot()에서 integrations 콜백을 포함한 옵션 객체를 사용할 수 있으며, 이를 통해 G+S 이벤트를 Amplitude 애널리틱스가 아닌 다른 분석 공급자에게 전달할 수 있습니다 (GSM-512).
  • [React Native] CTA 버튼에서 앱 내 탐색을 처리하기 위해 setRouter / unsetRouter SDK 메서드를 추가했습니다 (GSM-1169).

수정

  • [iOS] [Android] 별점 등급과 선택 상태를 음성해설/토크백에 알립니다(GSM-1155).
  • 필수 응답이 누락되었을 때 [Android] 설문조사 cta가 회색으로 표시됩니다(GSM-1151).
  • 앱 Compose 버전이 다른 경우 [Android] 드롭다운은 충돌하는 material3 API를 사용하지 않습니다(GSM-1147).
  • [iOS] 렌더링이 완료되기 전에 해제될 경우 넛지 렌더링을 건너뜁니다 (GSM-1139).
  • [iOS] [Android] 테마에서 CSS 색상 이름을 지원합니다 (GSM-1035).
  • [iOS] [Android] 테마 패딩은 컨테이너에 적용되며, 모든 콘텐츠 블록(제목, 본문, 이미지, 비디오, 설문조사, 버튼)은 테마의 "간격" 값만큼 균등하게 간격을 두고 있습니다. 기존 테마는 영향을 받지 않습니다(GSM-1127).
  • [iOS] [Android] '독립형' 사용 사례의 이벤트 속성에 가이드 및 설문조사 모바일 SDK 버전을 포함시킵니다(GSM-1116).
  • [iOS] [Android] '세로 분할' 또는 '가로 분할' 레이아웃을 사용할 때 중복 이미지를 표시하지 않습니다(GSM-1129).
  • [Android] 액티비티 간에 이동할 때 디버그 버튼이 중복되는 것을 방지합니다(GSM-1159).
  • [iOS] 미디어가 있는 세로 분할 팝오버 및 핀에 하나의 닫기 버튼을 표시합니다(GSM-1165).
  • [iOS] [Android] 카드 삽입 및 기타 유형의 레이아웃 및 미디어 정렬을 정리합니다 (GSM-1141).
  • [iOS] [Android] 이미지는 카드 모서리 반경 대신 테마의 버튼 모서리 반경을 사용합니다(GSM-1164).
  • [iOS] [Android] 카드 임베드 테두리 및 배경이 고정 높이와 일치하도록 합니다 (GSM-1163).
  • [iOS] [Android] 테스트 사용자 모드가 꺼져 있을 때 디버그 버튼을 숨깁니다(GSM-1156).
  • [Flutter] 인게이지먼트 플러그인을 설치할 때 mediaUrl을 전달하여 미디어 프록시 URL이 적용되도록 합니다 (GSM-1167).
  • [Android] [Flutter] ComponentActivity를 상속하지 않는 앱에서 미리보기 링크를 열 때 앱이 더 이상 충돌하지 않습니다 (GSM-1160).
  • [iOS] 이미지가 있는 안내서의 상단 및 하단 가장자리 근처에서 탭을 인식합니다(GSM-1179).
  • [Android] 대상 요소가 화면 밖으로 완전히 스크롤될 때 핀 흔들기를 숨깁니다(GSM-1180).
  • [iOS] [Android] 이미지 페이드 인 시간을 줄입니다(GSM-1181).

3.11.0

2026년 7월 1일 릴리스되었습니다. 플랫폼: Android, iOS, React Native, Flutter.

기능

  • [iOS] [Android] 가이드에 대한 "단계 유지" CTA 동작을 지원합니다(GSM-1118).
  • [Android] 오픈 키보드를 사용한 모달, 팝오버, 핀에 대한 전체 화면 텍스트 입력 편집 UI를 추가합니다(GSM-1056).
  • [iOS] [Android] 슈퍼 디버거 테스트 사용자 기능 및 테스트를 추가합니다(GSM-892, GSM-1117).

수정

  • [iOS] [Android] 웹 빌더에서 구성된 순서대로 가이드 콘텐츠 블록을 렌더링합니다(GSM-1083).
  • [iOS] [Android] 보이스오버/토크백은 배경 요소를 건너뛰고, 현재 단계에서 캐러셀 요소를 탐색합니다 (GSM-1112).
  • [Android] 긴 너드에서 CTA가 표시되도록 하십시오(GSM-1056).
  • [iOS] [Android] 제목/본문 및 콘텐츠 블록 대상 구간의 간격을 위해 테마에서 "gap" 변수를 사용합니다(기존 테마는 영향을 받지 않음)(GSM-1113).
  • [iOS] iOS 26+에서 기기를 회전한 후 전체 화면 키보드 편집 레이아웃을 수정합니다(GSM-1107).
  • [iOS] 시뮬레이션 컨텍스트가 실패할 경우 디버그 버튼을 숨깁니다(GSM-1115).
  • [iOS] 시뮬레이션 컨텍스트를 로드하지 못할 때 오류 상태와 함께 디버그 버튼을 표시합니다(GSM-1119).
  • [iOS] 보기 계층 구조 폴링을 이벤트 기반 모니터링으로 대체하고 포그라운드에서만 수행되도록 하십시오(GSM-1125).
  • [iOS] 뷰 계층 구조 모니터링에서 SwiftUI 호스팅-뷰 레이아웃 변경 사항을 관찰하세요(GSM-1125).
  • [플러터]는 "탭 요소" CTA 동작을 지원합니다(GSM-1029).
  • [플러터] 지원 "요소 탭" 트리거(GSM-1028).
  • [Flutter] 스크롤할 때 대상 요소에 핀을 고정합니다(GSM-1027).

3.10.0

2026년 6월 11일 릴리즈됨. 플랫폼: Android, iOS, React Native, Flutter.

기능

  • [iOS] [Android] 지원 설문조사 입력 "프롬프트"(GSM-1073).
  • [iOS] 모달, 팝오버, 오픈 키보드를 사용하는 핀에 대한 전체 화면 텍스트 입력 편집 UI를 추가합니다(GSM-1056).

수정

  • [iOS] [Android] NPS 설문조사에 테마 타이포그래피와 색상만 적용하십시오(GSM-1051).
  • [iOS] 미디어 블록 사용 시 사용자 지정 팝오버/핀/툴팁 너비가 올바르게 적용되도록 합니다(GSM-1045).
  • [iOS] 고립된 핀 가이드 "마커"가 정리되었는지 확인하십시오(GSM-1087).
  • [iOS] [Android] 비활성화된 기본 버튼의 스타일을 지정합니다(GSM-1080).

3.9.0

2026년 6월 4일 릴리즈됨. 플랫폼: Android, iOS, React Native.

기능

  • [iOS] [Android] 이벤트 기반 트리거 "지연" 기능을 지원합니다(GSW-552).
  • [Flutter] Swift 패키지 관리자를 지원합니다(GSM-1048).
  • 우선 순위 버킷 첫 사용 후 세부적인 가이드 주문을 위한 [iOS] [Android] 지원sub_priority 필드(GSW-425).

수정

  • 기기 회전 시 [Android] 리포트 콘텐츠 유지(GSM-1011).
  • [iOS] 배너에 대한 상단 안전 영역 패딩을 추가합니다(GSM-1053).
  • [Flutter] SDK가 안드로이드의 네이티브 싱글턴을 준수하지 않음(GSM-1057).
  • [iOS] 참여 창이 호스트 앱 창 위에 표시되도록 보장(GSM-1061).
  • [iOS] 대상 요소가 다른 창에 의해 가려질 때 핀 너지 숨기기(GSM-1061).
  • [iOS] 핀 너지 마스크가 항상 정리되도록 하십시오(GSM-1061).
  • [iOS] [Android] 앱 '버전'을 기반으로 사용자에게 너지를 타겟팅합니다(GSM-1068).
  • [iOS] 캐러셀 가이드 하단의 사각형 모서리를 사용하십시오(휴대폰에만 해당)(GSM-1077).

3.8.0

2026년 5월 7일 릴리즈됨. 플랫폼: Android, iOS, React Native, Flutter.

기능

  • [iOS] [Android] 세션에서 N개의 이벤트 후에 트리거되는 너지에 대한 지원(GSW-454).

수정

  • [Android] 너지 뒤의 배경 요소에 대한 TalkBack 포커스 차단(GSM-1018).
  • [Android] 기기 회전 후 원래 디버그 너지 대신 선택한 디버그 너지를 표시합니다(GSDK-937).
  • [Android] 배너에 대한 상단 안전 영역 패딩을 추가합니다(GSM-1033).
  • [iOS] 핀 화살표를 배치하는 데 사용합니다actualContentSize(GSM-1040).
  • [iOS] 가이드/설문조사가 렌더링될 때 글꼴 크기를 변경하면 요소를 탭할 수 없는 상태가 됩니다(GSM-899).
  • [iOS] JS 콜백 후 기본 스레드에 앵커 가능한 너지 UI를 배치합니다(GSM-1041).

3.7.0

2026년 4월 28일 릴리즈됨. 플랫폼: Android, iOS, React Native, Flutter.

기능

  • [iOS] [Android] 사용자가 버그 리포트를 제출하기 전에 종료하려고 할 경우 알림을 표시합니다(GSDK-945).
  • [iOS] [Android] [Flutter] [React Native] 초기화autoRefreshInterval 옵션에 추가하고 부트 옵션에 이를 전달하는 것을 더 이상 사용하지 않습니다(GSM-1014).
  • [Android] 디버그 로그 화면 및 버그 리포트 로그 추가(GSDK-911).

수정

  • [iOS] 너지 뒤의 배경 요소에 대한 VoiceOver 초점 차단(GSM-1018).
  • [iOS] 제목이 후행 정렬일 때 닫기 버튼을 리드 정렬(GSM-1019).
  • [Android] 기기 회전 후에도 텍스트 애니메이션을 계속하도록 업데이트합니다(GSDK-923).

3.6.0

2026년 4월 15일 릴리즈되었습니다. 플랫폼: Android, iOS, React Native, Flutter.

기능

  • 디버그 오버레이를 위한 [Android] 업데이트 UI(GSDK-932).
  • [iOS] [Android] 디버그 지원 및 버그 리포트 화면을 추가합니다(GSDK-913).
  • [iOS] 디버그 로그 화면 및 버그 리포트 로그 추가(GSDK-911).
  • [Flutter] [React Native] Flutter 및 React Native에updateLanguage SDK 메소드를 추가하세요(GSM-358).

수정

  • [iOS] [Android] 가이드 및 설문조사에서 다중 액션 CTA를 지원합니다.
  • [iOS] [Android] 가이드 및 설문조사에서 조건부 동작을 지원합니다.

3.5.0

2026년 4월 9일 릴리즈되었습니다. 플랫폼: Android, iOS, React Native, Flutter.

기능

  • 디버그 오버레이를 위한 [Android] 업데이트 UI(GSDK-932).
  • [Android] [React Native] Android용 HLS 비디오 재생에 대한 지원을 추가합니다(GSDK-924).

수정

  • [Android] 디버그 버튼의 위치를 변경하여 기기 회전 시 화면에서 벗어나지 않도록 합니다(GSDK-927).
  • [iOS] 수퍼 디버거에서 중단 신호 충돌이 발생하는 문제를 해결했습니다(GSDK-928).
  • [iOS] 텍스트 애니메이션이 서로를 차단하지 않도록 시퀀스 너지 렌더링을 수정했습니다(GSDK-909).
  • [Android] [React Native] [Flutter] 호스트 앱도 이에 의존하는 경우 클래스 중복 오류가 발생할 수 있습니다org.commonmark(GSDK-940).
  • [iOS] 양식 구성 요소 및 마크다운에 글꼴 두께가 적용되는지 확인하십시오(GSDK-805).
  • [iOS] CSS 시스템 글꼴 키워드가 테마의 글꼴 패밀리로 지정되어 있는 경우 시스템 글꼴(GSDK-805)을 사용하십시오.
  • [iOS] 마크다운의 글꼴 두께가 웹 미리보기와 일치하는지 확인하십시오(GSDK-805).

성능 향상

  • [iOS] 가변 글꼴을 사용하여 SDK 번들 크기를 약 500KB 줄입니다(GSDK-805).

3.4.0

2026년 3월 31일 릴리즈되었습니다. 플랫폼: Android, iOS, React Native.

기능

  • [iOS] [Android] 디버거를 통해 보관되지 않은 전체 가이드나 설문조사를 실행하세요(GSDK-893).
  • [iOS] [Android] 정기적으로 핀의 위치를 변경하기 위한 디버그 모드를 추가합니다(GSDK-910).
  • [iOS] [Android] 이벤트가 G+S SDK에서 오고 가는지 여부를 나타내기 위해 디버그 모드 "telltale"를 추가하십시오(GSDK-912).
  • [iOS] 디버그 오버레이 UI 업데이트(GSDK-913).

수정

  • [iOS] 디버그 버튼의 위치를 변경하여 기기 회전 시 화면에서 벗어나지 않도록 합니다(GSDK-927).

3.3.1

2026년 3월 23일 릴리즈됨. 플랫폼: Android, iOS, React Native.

수정

  • [iOS] [Android] [React Native] SDK가 완전히 초기화되기 전에 SDK 메서드 screen 가 호출될 경우 제대로 작동하지 않는 문제를 수정했습니다(GSDK-915, assistance-browser PR #1072).
  • [React Native] Swift 6.0 지원을 다시 활성화하기 위해 후행 쉼표를 제거했습니다.
  • [Android] [iOS] 설문조사 콘텐츠 너비를 너지 단계 유형과 일치하도록 수정했습니다(GSDK-908).
  • [Android] 전화 가로 모드의 배너 크기 조정을 수정했습니다(GSDK-907).
  • [iOS] 텍스트 애니메이션이 완료된 후 배너 버튼이 서서히 나타나도록 수정했습니다(GSDK-904).
  • [iOS] [Android] [React Native] SDK 메서드에서 불필요한 1초 지연을 제거했습니다screen(GSDK-898).

3.3.0

2026년 3월 17일 릴리즈됨. 플랫폼: Android, iOS, React Native.

기능

  • [iOS] 평점 버튼 패딩에 대한 테마 지원을 추가합니다(GSDK-803).
  • [Android] [iOS] 텍스트 애니메이션 후 버튼이 페이드 인되고 이미지 페이드 인을 추가합니다(GSDK-889).
  • [Android] [iOS] 포어그라운드된 앱의 SDK 새로 고침(GSDK-886).
  • [Android] [iOS] 세션 변경 시 재부팅 호출을 새로 고침으로 대체합니다(GSDK-886).

수정

  • [Android] [iOS] 진행 중일 때 링크 구문을 보여주는 애니메이션 텍스트를 수정했습니다(GSDK-601).
  • [Android] 애니메이션 중간에 코루틴이 취소될 때 텍스트가 멈추는 문제를 수정했습니다(GSDK-891).
  • [iOS] 툴팁이 이미지와 함께 잘못 정렬되어 있고 닫을 수 없는 문제를 수정했습니다(GSDK-890).
  • [iOS] 닫을 수 없는 별점 및 숫자 설문조사 문제를 수정했습니다(GSDK-906).

3.2.0

2026년 3월 6일 릴리즈됨. 플랫폼: Android, iOS, React Native.

기능

  • [React Native]는 “user_properties”를 “boot” SDK 메소드에 전달할 수 있도록 허용합니다(GSDK-869).
  • [Android] 선 높이에 대한 테마 지원을 추가합니다(GSDK-820).
  • [Android] 평점 버튼 패딩에 대한 테마 지원을 추가합니다(GSDK-822).
  • [Android] [iOS] 양식 컨트롤 및 버튼 그림자에 대한 테마 지원을 추가했습니다(GSDK-806, GSDK-824).

수정

  • [Android] 다중 단계 핀에 대한 단계 카운터 업데이트(GSDK-876).
  • [iOS] 네비게이션 계층 구조의 막대를 확인할 때 보기 대신 currentParent를 사용하십시오(GSDK-874).
  • [iOS] 레이아웃 타이밍을 수정하기 위해 핀 위치를 연기합니다(GSDK-868).
  • [Android] 수평 핀 UI 및 위치 지정을 수정했습니다(GSDK-815).
  • [Android] [iOS] vimeo 및 loom 비디오에 대한 앱 내 지원을 개선합니다(GSDK-338, GSDK-861).
  • [Android] nps 형식 버튼을 사용하여 숫자 설문조사에 대한 너지 폭을 늘립니다(GSDK-833).

3.1.1

2026년 2월 23일 릴리즈됨. 플랫폼: Android, iOS, React Native.

수정

  • [Android] [iOS] 완료 또는 해지 시 설문조사 응답을 재설정합니다(GSDK-854).

3.1.0

2026년 2월 13일 릴리즈됨. 플랫폼: Android, iOS, React Native.

기능

  • [Android] [iOS] [React Native] Onboot에서는 장치 ID가 지정되어 있는 한 "사용자 ID"가 null이거나 비어 있을 수 있도록 허용합니다(GSDK-732).

수정

  • [Android] [iOS] 자동 진행 로직을 수정했습니다(GSDK-859).
  • [iOS] 경합 조건으로 인해 뷰 계층 구조가 업데이트될 때까지 핀 너지가 렌더링되지 않습니다(GSDK-827, GSDK-844).

3.0.0

2026년 2월 11일 릴리즈됨. 플랫폼: Android, iOS, React Native.

호환성을 깨뜨리는 변경 사항

  • [iOS]AmplitudeEngagement는 이제 클래스가 아닌 인터페이스입니다. 새 인스턴스(3.0.0 기준)는 AmplitudeEngagementFactory.make 생성자 대신 AmplitudeEngagement를 사용하여 생성됩니다(GSDK-690).

기능

  • [Android] [iOS] [React Native] 표시된 전체 가이드 또는 설문조사를 일시적으로 숨기는 enable와 이를 다시 표시하는 disableSDK 메서드가 추가되었습니다(GSDK-513).
  • [React Native] SDK 바인딩에 대한 React Native Add SDK 메서드shutdown(GSDK-769).
  • [Android] [iOS] [React Native]Minimum SDK version 이전 SDK 버전에서 가이드 및 설문조사를 초기화하지 않도록 앱 관리에 대한 지원을 추가하세요.

수정

  • [Android] [iOS] 테마 문제를 수정했습니다(GSDK-845, GSDK-847).
  • [Android] 모달의 외부를 탭하여 닫는 동작에 대한 수정(GSDK-850).

2.1.1

2026년 2월 2일 릴리즈됨. 플랫폼: Android, iOS, React Native.

수정

  • [React Native] 트레일링 쉼표(Trailing comma) 이슈로 인해 6.1 미만 버전의 Swift 컴파일러에서 빌드 오류가 발생하는 문제를 수정했습니다.
  • [iOS] iOS 26 기기 회전 다음 기간동안 발생하는 키보드 레이아웃 버그를 수정했습니다(GSDK-632).
  • [Android] 구성 변경 후 너지 키보드를 복원합니다(GSDK-831).

2.1.0

2026년 2월 2일 릴리즈됨. 플랫폼: Android, iOS, React Native.

기능

  • [Android] [iOS] SDK의 자동 새로 고침 간격을 구성하는 autoRefreshIntervalSeconds옵션에 대한 지원을 추가합니다(GSDK-799)AmplitudeBootOptions.
  • [Android] [iOS] SDK의 자동 새로 고침 간격을 즉시 구성하기 위해 SDK 메서드를 추가했습니다setAutoRefreshInterval(GSDK-799).
  • [Android] [iOS] 타겟팅 데이터의 새로 고침을 수동으로 트리거하기 위한 SDK 메서드 추가(GSDK-799)refresh.

수정

  • [Android] [iOS] 테마 문제를 수정했습니다(GSDK-676).
  • [iOS] 투어(다단계 안내서)에서 다른 안내서 다음에 오는 경우 핀 안내서가 표시되도록 보장합니다(GSDK-827).
  • [Android] 키보드가 표시될 때 넛지 위치를 조정합니다(GSDK-782).
  • [Android] 링크 모양 및 클릭 동작을 수정했습니다(GSDK-821).
  • [Android] 양식 제어 테마를 사용하도록 구성 요소를 업데이트합니다(GSDK-835).
  • [Android] 세션/활동 변경 후에도 호스트 앱이 여전히 터치 이벤트를 수신하는지 확인하십시오(GSDK-198).

성능 향상

  • [iOS] View 계층 구조 추적은 이제 "비동기식"으로 되어 메인 스레드를 방해하지 않습니다(GSDK-819).

2.0.3

2026년 1월 26일 릴리즈되었습니다. 플랫폼: Android, iOS, React Native.

수정

  • [Android] [iOS] 단계별 탐색 시 설문조사 값을 유지합니다(GSDK-582).
  • [Android] [iOS] 텍스트 애니메이션이 완료될 때까지 버튼을 숨기십시오(해당되는 경우)(GSDK-780).
  • [Android] 팝오버가 시스템 막대와 겹치는 이유는 호스트 앱에서 WindowInsets를 적절하게 사용하지 않았기 때문입니다(GSDK-784).
  • [Android] 루트 뷰가 창에 연결될 때까지 기다리게 하여 새 활동으로 전환 시 발생하는 충돌을 해결했습니다enableEdgeToEdge()(GSDK-768).
  • [iOS] 모달 가이드 및 설문조사가 호출될 때 올바르게 해제되는지 확인하십시오shutdown()(GSDK-790).
  • [iOS] 기본 콘텐츠 정렬을 leading으로 업데이트했습니다(GSDK-796).
  • [iOS] 필요에 따라 키보드를 해제하기 위해 containerView를 EngagementWindow로 식별하십시오 GSDK-797.
  • [iOS] 스크롤하지 않고 기타 텍스트 필드를 표시하려면 너지를 확장하십시오(GSDK-779).
  • [React Native] 내부 참여 안드로이드 종속성 버전이 잘못 설정되었습니다.

2.0.2

2026년 1월 9일 릴리즈되었습니다. 플랫폼: iOS.

수정

  • 더 넓은 호환성을 위해 Xcode 16.2 / Swift 6.0.3을 사용하여 [iOS] SDK 프레임워크를 컴파일함(GSDK-786).

2.0.1

2026년 1월 7일 릴리즈됨. 플랫폼: Android, iOS, React Native.

기능

  • [Android] [iOS] ignoreAnalyticsAutomaticScreenTracking 옵션을 AmplitudeInitOptions에 추가하여 자동 화면 추적에 대한 기본 Engagement SDK 동작을 구성(GSDK-750).

수정

  • [Android] 너지가 사라질 때 애니메이션 큐를 재설정합니다(GSDK-518).
  • [Android] [iOS] SDK에서 "boot"를 호출하지 않고 사용할 경우 디버그 모드에서 충돌이 발생합니다.
  • [iOS] 요소 선택기와 미리보기 모드가 다른 모드가 활성화되어 있을 때 시작될 수 있는지 확인하십시오(GSDK-717).
  • [Android] [iOS] Engagement SDK(GSDK-781)에서 기본적으로 Amplitude 애널리틱스 자동 화면 추적 무시.

2.0.0

2026년 1월 2일 릴리즈됨. 플랫폼: Android, iOS, React Native.

호환성을 깨뜨리는 변경 사항

  • [Android]AmplitudeEngagement는 이제 클래스가 아닌 인터페이스이며, options 및 apiKey에 더 이상 액세스할 수 없습니다.
  • [Android] [iOS]AmplitudeInitOptions.Options는 제거되었으며 logLevel 이제 옵션 객체의 최상위 수준에 있습니다.
  • [Android]handlePreviewLinkIntent는 더 이상 사용되지 않으므로 대신 사용하십시오handleLinkIntent(GSDK-322).

기능

  • [Android] [iOS] 공유 링크에 대한 지원을 추가합니다(GSDK-322).
  • [Android] [iOS] 사용자 지정 툴팁 크기에 대한 지원을 추가합니다(GSDK-353).
  • [React Native] serverZone, serverUrl, cdnUrl, mediaUrl, logLevel 및 locale 초기화 옵션에 대한 지원을 추가했습니다(GSDK-767).

수정

  • [Android] [iOS] 핀 가시성 논리 및 마스크 상호 작용(GSDK-748).
  • [iOS] 태블릿에서 배너 콘텐츠를 세로로 확장할 수 있도록 허용합니다(GSDK-759).
  • [iOS] 제약 조건에서 실제 콘텐츠 크기를 사용하기 전에 유한 검사를 추가하십시오(GSDK-761).
  • [iOS] 너지가 표시될 때 상태 표시줄의 가시성 상태를 유지합니다(GSDK-758).
  • [iOS] 스크롤된 핀의 화살표 정렬 오류가 수정되었습니다(GSDK-725).
  • [Android]는 호스트 앱을 충돌시키는 대신 모바일 SDK를 초기화하지 못하는 문제를 정상적으로 처리합니다(GSDK-775).
  • [Android] 스텝 카운터 크기 및 배경색에 대한 테마 수정(GSDK-538).
  • [Android] "null"사용자 및 기기 ID를 올바르게 처리하십시오(FOO-2908).
  • [iOS] 대상 뷰 isObscuredByPresentedViewController가시성 검사를 제거합니다(GSDK-720).
  • [iOS] 툴팁은 '닫기' 버튼을 사용하여 닫은 후 다시 열 수 있습니다(GSDK-776).
  • [Android] [iOS] 테마의 가이드/설문조사 카드에 드롭 섀도우를 올바르게 적용합니다(GSDK-772).
  • [iOS] 사용자 속성이 "_setUserProperties"를 통해 업데이트될 때 일치하는 가이드/설문조사(있는 경우)를 트리거합니다(FOO-2911).
  • [React Native] React Native 플러그인은 Amplitude 초기화에 사용된 서버 영역을 기반으로 serverZone을 자동으로 설정합니다(GSDK-767).

성능 향상

  • Amplitude 애널리틱스에서 G+S SDK로의 [iOS] 이벤트 전달은 이제 "비동기식"으로 이루어지며 메인 스레드(GSDK-763)를 방해하지 않습니다.

1.8.1

2025년 12월 4일 출시. 플랫폼: iOS.

수정

  • [iOS] 기본 제목+텍스트 정렬을 왼쪽(leading)으로 업데이트했습니다(GSDK-733).
  • Foundation.Data를 이벤트 속성 값으로 사용하면 앱이 충돌하는 원인이 되는 [iOS] 버그(GSDK-736).

1.8.0

2025년 11월 26일 출시. 플랫폼: Android, iOS, React Native.

기능

  • [iOS] 긴 콘텐츠를 위해 스크롤 가능하도록 수정된 Nudge(GSDK-693).
  • [Android] [iOS] 링크 소스를 사용하여 너지 참여 이벤트를 추적합니다(GSDK-144).
  • [Android] [iOS] 태블릿에서 캐러셀+모달에 대한 모달 높이 설정이 반영되었습니다.

수정

  • [Android] nps 버튼 높이를 수정했습니다(GSDK-708).
  • [iOS] 기기 방향 변경에 따라 마스크 + 대상 뷰를 다시 렌더링합니다(GSDK-441).
  • [Android] 캐러셀의 위쪽과 아래쪽에 테마 배경색을 사용하십시오(GSDK-731).
  • [iOS] 대상 구간 단계를 이동할 때 핀의 배경 마스크가 깜박이는 문제(GSDK-660).
  • [iOS] 가이드는 올바른 위치로 이동하기 전에 왼쪽 위 모서리에 잠시 렌더링됩니다(GSDK-718).
  • 폼 팩터의 [Android] 드롭 그림자는 Surface에 의해 클리핑되고 복제됩니다(GSDK-259).
  • [iOS] 버튼 블록에 조건부 동작에 대한 지원을 추가했습니다(GSDK-726).
  • [Android] ctas 대상 구간 간격 업데이트(GSDK-734).

1.7.0

2025년 11월 18일 출시되었습니다. 플랫폼: Android, iOS, React Native.

수정

  • 참여 분석 플러그인을 "amplitude.add(...)"와 함께 사용할 때 [React Native] Type 오류 발생 (GSDK-698).
  • 왼쪽 정렬이 구성되었을 때 [Android] 안내서 제목이 잘못 가운데에 정렬되었습니다(GSDK-701).
  • [Android]에서 밑줄("_") 구분된 글꼴 파일을 허용합니다(GSDK-701).
  • [Android] 가이드를 렌더링할 때 올바른 모서리 반지름과 외부 패딩을 사용하십시오(GSDK-701).
  • StoreKit 콘텐츠(예: manageSubscriptionsSheet)를 표시한 후 [iOS] 앱이 응답하지 않습니다(GSDK-699).

1.6.1

2025년 11월 13일 출시. 플랫폼: Android, iOS, React Native.

수정

  • [Android] [iOS] 설문조사 및 미디어 블록 순서 조정 업데이트(GSDK-689).
  • [iOS] uikit click 요소의 스레딩 문제를 수정했습니다(GSDK-571).
  • [iOS] 투명한 시스템 탐색 막대 뒤에 있는 사용자 지정 탐색 막대의 너지 앵커를 수정했습니다(GSDK-664).
  • [Android] 메인 스레드의 성능을 개선하기 위해 뷰 계층 구조 스캔을 리팩터링합니다.

버전 1.6.0

2025년 11월 7일 출시. 플랫폼: Android, iOS, React Native.

기능

  • [Android] [iOS] 프록시 지원(GSDK-630). 프록시로 이동합니다.
  • [Android] [iOS]는 4개의 새로운 팝오버 가이드 위치(위쪽 가운데, 아래쪽 가운데, 왼쪽 가운데, 오른쪽 가운데)를 지원합니다(FOO-2639).

수정

  • [Android] [iOS] 모든 SDK 메소드에 디버그 로깅을 추가합니다.
  • [Android] 부팅 시 Null 또는 빈 사용자 ID를 적절하게 처리합니다(GSDK-681).
  • [Android] 테마 수정(잘못된 색상, 텍스트 정렬, 팝오버 안내선 너비 등) (GSDK-671).
  • [Android] 핀 대상이 화면 밖으로 스크롤되면 대상이 다시 나타날 때 안내선이 다시 표시되어야 합니다(GSDK-651).
  • [iOS] [Android] 태블릿에서는 기기의 최대 너비가 아닌 테마의 모달 캐러셀 최대 너비가 사용됩니다(GSDK-633, GSDK-616).
  • [iOS] 새 미리보기를 시작할 때 이전에 미리보았던 안내서를 표시하지 않습니다(GSDK-595).
  • [iOS] 브라우저에서 열린 URL이 기본 UI 스레드에서 열려 있는지 확인하십시오(GSDK-652).
  • [Android]에서 가이드 콘텐츠가 오른쪽으로 정렬되어 있을 때 이상한 공백이 나타납니다(GSDK-647).
  • [iOS] 사용자 ID가 Amplitude 애널리틱스 SDK를 통해 nil로 설정된 경우 자동으로 shutdown()을 호출합니다(#436).
  • [iOS] 모달 가이드가 화면 가운데에서 왼쪽 위로 이동합니다(GSDK-627).
  • CTA 버튼을 통해 콜백을 실행할 때 [iOS] 앱이 중단됩니다(GSDK-458).
  • 텍스트 애니메이션을 사용하는 [iOS] 배너에는 빈 텍스트가 있습니다(GSDK-638).
  • 세로로 스크롤할 때 [iOS] 툴팁 마커가 대상 요소와 함께 유지되지 않습니다(GSDK-607).
  • 포인터가 없는 [iOS] 툴팁이 나타납니다(GSDK-607).
  • [iOS] 사용자가 주도하는 툴팁 해제는 툴팁 마커를 숨겨서는 안 됩니다(GSDK-607).
  • [iOS] analytics.identify에 전달된 사용자 속성이 Guide 사용자 속성 보간에 사용되는지 확인하십시오(#415).
  • [iOS] 툴팁과 기본적으로 닫힌 핀에 대한 깜박임을 방지합니다(GSDK-659).
  • [iOS] 핀이 navbar 요소를 대상으로 삼을 수 있도록 허용합니다(GSDK-664).
  • [iOS] 닫기 버튼("x") 패딩은 테마의 값을 사용합니다(GSDK-661).
  • [iOS] 이미지가 가끔 로드되지 않습니다(GSDK-656).

1.5.2

2025년 10월 31일 출시. 플랫폼: iOS, React Native.

수정

  • setUserId를 호출할 때 [iOS] [React Native] 충돌이 발생합니다.

1.5.1

2025년 10월 30일 출시. 플랫폼: Android, iOS, React Native.

호환성을 깨뜨리는 변경 사항

  • [Android] [iOS] cleanup()및 reboot()기능이 제거되었습니다. shutdown()대신 사용하십시오.

수정

  • [Android] [iOS] [React Native] 모든 활성 너지를 뷰에서 shutdown()제거하도록 보장합니다.
  • [Android] [iOS] [React Native] JSON 안전하지 않은 값을 직렬화할 수 있는지 확인하세요.

1.5.0

2025년 10월 21일 출시되었습니다. 플랫폼: Android, iOS, React Native.

호환성을 깨뜨리는 변경 사항

  • [Android] [iOS] [React Native] 새 사용자 ID로 boot()를 호출하기 전에 shutdown()를 호출해야 합니다.

기능

  • [Android] [iOS] 사용자 지정 글꼴 지원(GSDK-578, GSDK-620).
  • [Android] 분석 플러그인은 사용자 ID의 변경 사항을 추적합니다(#355).
  • [Android] [iOS] 지원 안내서 제목의 링크 및 이탤릭체(GSDK-600).

수정

  • [iOS] QuickJS와 관련된 여러 차례 충돌(GSDK-640, GSDK-625).
  • [Android] 앱에서 여러 액티비티나 '일반' 액티비티(예: AppCompatActivity 아님)가 있는 가이드를 렌더링할 때 충돌이 발생합니다(GSDK-589).
  • 디버거를 사용할 때 [iOS] 미리보기가 충돌합니다(#337).
  • 툴팁을 닫을 때 툴팁 안내서가 숨겨지지 않는 [iOS] "화살표"(GSDK-609).
  • [iOS] 캐러셀 가이드는 대형(태블릿) 화면에서 올바른 크기입니다(GSDK-616).
  • [iOS] 핀 폼 팩터 "오프셋" 위치 지정 + 정렬 버그(GSDK-593).
  • [iOS] 모달 및 팝오버 안내서는 구성된 위치에 머무르지 않고 왼쪽 상단으로 스냅됩니다(GSDK-627).
  • [Android] [iOS] [React Native] 가이드를 닫을 수 없게 만들 수 있는 경합 상태(#355).
  • 중복된 캐러셀 가이드를 유발하는 [Android] 조건(GSDK-641).
  • [iOS] 텍스트 애니메이션이 항상 제대로 렌더링되지 않습니다(GSDK-638).
  • [Android] [iOS] 문제로 인해 다크 모드 테마가 사용되지 않거나 잘못된 색상이 사용됩니다(GSDK-596, GSDK-612).
  • [Android] [iOS] 동작이 숨겨져 있을 때 여분의 간격을 제거하십시오(GSDK-421).
  • [Android] '스마트 지연' 트리거와 관련된 문제일 수 있습니다(GSDK-605).
  • 이제 [iOS] 안내서 제목 글꼴 두께가 기본적으로 세미 볼드로 설정됩니다(GSDK-615).

이 내용이 도움이 되었나요?