01
연결 파일 전체를 준비
applinks.details가 포함된 JSON을 붙여 넣으세요. 예시는 최신 appIDs와 components를 사용하지만 이전 appID와 paths도 검사합니다. 구문 오류에는 행과 열이 표시됩니다.
- 예시에는 일반 경로, 제외 경로, 쿼리 조건이 함께 있습니다.
iOS / Android Dev Tools
AASA 검증먼저 적용되는 규칙 확인
AASA JSON과 URL 여러 줄을 입력하고 필요하면 App ID를 고르세요. 도메인에 요청하지 않고 규칙만 검사합니다.
AASA 검증
입력
보고서
예시를 수정하고 검증하세요.
이 브라우저 탭에서 검사하며 입력한 도메인이나 URL에 요청하지 않습니다.
옵션
비우면 선언된 모든 App ID를 표시하고, 입력하면 정확히 일치하는 ID만 표시합니다.
예시를 수정하고 검증하세요.
일부 링크만 Safari에 남는다면 AASA 검증으로 배포 전에 어떤 규칙이 먼저 URL을 차지하는지 볼 수 있습니다. JSON 구문만 맞는 것으로는 뒤에 둔 제외 규칙이 무시되는 이유를 알기 어렵습니다.
이 AASA 검증 결과는 붙여 넣은 파일의 App ID와 결정 규칙을 보여 줍니다. 서버의 파일 제공 상태, Apple CDN 캐시, 설치된 앱의 실제 동작은 별도로 확인해야 합니다.
AASA 검증을 먼저 하는 이유
배포 전 경로 결과 분리
AASA 검증은 여러 URL을 같은 순서의 규칙에 적용해 포함, 제외, 불일치를 나눠 보여 줍니다. 서버에 파일을 올리지 않고 경로 범위 오류를 찾을 수 있습니다.
가려진 제외 규칙 발견
넓은 규칙이 먼저 일치하면 뒤의 제외 규칙에는 도달하지 않습니다. AASA 검증은 실제로 결정한 규칙 번호와 명백히 가려진 항목을 표시합니다.
로컬 규칙 결과와 기기 결과를 구분해 읽기
02
URL과 앱을 지정
HTTPS URL이나 슬래시로 시작하는 경로를 한 줄에 하나씩 넣습니다. App ID를 비우면 선언된 모든 앱의 결과가 나오며 입력을 바꾸면 이전 보고서가 만료됩니다. 이 경로 매칭 테스트는 네트워크를 사용하지 않습니다.
- Ctrl/Cmd + Enter로 수동 실행할 수 있으며 URL에 접속하지 않습니다.
03
결정 규칙을 확인
결과의 details와 규칙 번호를 보고 보고서를 내보내세요. 포함 판정은 붙여 넣은 규칙이 앱을 선택했다는 뜻일 뿐, 배포와 기기 항목은 미확인입니다.
- 만료된 보고서는 복사하거나 다운로드할 수 없습니다.
앱과 URL별로 남는 결정 근거
새 형식과 이전 형식
components의 경로·쿼리·프래그먼트·exclude와 paths의 순서형 NOT 제외를 구분해 처리합니다. 서로 다른 두 문법을 하나로 뭉개지 않습니다.
App ID별 판정
같은 URL을 선언된 모든 앱에 시험하거나 특정 App ID만 고를 수 있습니다. 파일에 없는 ID와 경로가 불일치한 ID는 다른 상태로 나옵니다.
검토용 전체 보고서
AASA 검증 보고서에는 구조 문제, 입력 행, 결정 규칙, 미확인 배포 항목이 포함되어 릴리스 기록과 함께 검토하기 좋습니다.
로컬에서 확인할 수 있는 범위
- 호스팅 상태는 확인하지 않음
- AASA 검증은 도메인을 가져오지 않습니다. TLS, 리다이렉트, Content-Type, 공개 접근, Apple CDN 복사본은 모두 미확인으로 남습니다.
- 알 수 없는 문법은 판정 보류
- substitutionVariables나 혼합 형식 또는 지원하지 않는 구성 요소 키는 불일치로 간주하지 않고 판정 불가로 표시합니다.
- 서명된 앱 정보는 볼 수 없음
- JSON의 Team ID와 Bundle ID 형식은 점검할 수 있어도 실제 앱의 서명된 entitlement, 사용자 선택, Safari 이동 맥락은 AASA 검증으로 알 수 없습니다.
- 다른 서비스는 범위 밖
- webcredentials, appclips, Android assetlinks.json은 검사하지 않습니다. 파일에 있으면 미검사로 알리고 전체 AASA가 유효하다고 주장하지 않습니다.
AASA 검증에서 자주 생기는 질문
AASA 파일이 있어도 유니버설 링크가 앱을 열지 않는 이유는 무엇인가요?
로컬 AASA 검증은 붙여 넣은 규칙의 일치만 보여 줍니다. 실제로는 배포 파일, CDN, Associated Domains, 설치 상태, 클릭 위치도 중요하므로 기기에서 따로 시험하세요.
AASA 파일은 어디에 배포해야 하나요?
해당 호스트의 /.well-known/apple-app-site-association 또는 루트 경로에 확장자 없이 배포합니다. 이 도구는 서버에 접속하지 않으므로 배포 여부는 미확인입니다.
AASA 경로 규칙이 URL과 일치하는지 어떻게 확인하나요?
URL을 한 줄씩 입력하면 각 App ID에서 처음 결정한 details와 규칙 번호를 표시합니다. 제외와 단순 불일치도 구분합니다.
Apple CDN에 변경 사항이 늦게 반영되는 이유는 무엇인가요?
Apple CDN과 기기의 캐시가 관련됩니다. 이 페이지는 네트워크 요청을 보내지 않으므로 CDN 복사본과 실제 기기를 따로 점검해야 합니다.
AASA 검증만으로 실제 기기 동작을 보장할 수 있나요?
아니요. JSON 규칙의 로컬 결과이며 앱 서명, 서버 응답, 설치 상태와 Safari 동작까지 검증하지는 못합니다.
더 확인할 규칙이 있나요?