browser_specific_settings

본 글은 Mozilla Developer Networks Web Docs의 browser_specific_settings 페이지를 번역한 내용입니다. MDN 문서 라이선스에 따라 CC-BY-SA 2.5 라이선스가 적용됩니다. (하단 라이선스 표기와 무관합니다.) MDN의 기여자 분들께서 작성해주셨습니다. (기여자 명단)
또한 Mozilla의 MDN 지역화 정책 변경으로 인해 블로그에 올리는 것이므로, 이후 번역이 가능하도록 변경될 경우 최신 반영 사항은 모두 MDN에 반영하며 블로그에는 반영하지 않습니다.
한국어 번역본의 내용은 어떠한 경우에도 보증하지 않으며 MDN의 지역화 정책에 변동이 없으면서도 요청이 있을 때에만 업데이트된 문서 내용을 반영할 것입니다. 따라서 되도록 원본 문서를 참고하시기 바랍니다.

형태	Object
필수 여부	일반적으로는 아님 (관련 게시글: 원본 / 번역본)
예시	"browser_specific_settings": { "gecko": { id: "addon@example.com", "strict_min_version": "42.0" } }

설명

browser_specific_settings 키는 특정 호스트 애플리케이션을 지칭하는 값을 가집니다.

Firefox (Gecko) 속성

Firefox는 브라우저의 특정 설정들을 gecko라는 하위 키 안에 저장하며, 다음과 같은 속성 값을 가집니다.

id

부가 기능의 ID를 말합니다. Firefox 버전 48부터 선택 사항이 되었으나, 그 이전에는 필수였습니다. 관련 게시글(원본 / 번역본)을 참조하셔서 부가 기능 ID가 필요한 상황에 대해 알아보세요.

strict_min_version

Gecko의^[각주:1] 최소 지원 버전을 설정합니다. 버전을 설정할 때, "*"^[각주:2]는 허용되지 않습니다. 기본 값은 "42a1"입니다.

strict_max_version

Gecko의 최대 지원 버전을 설정합니다. Firefox의 현재 버전이 부가 기능의 최대 지원 버전보다 높다면, 설치가 되지 않거나 사용 중이던 부가 기능이 비활성화됩니다. 기본 값은 "*"으로 최대 지원 버전에 대한 확인을 하지 않는 설정 값입니다.

update_url

부가기능 업데이트 manifest 파일의 주소를 설정합니다. 주소는 반드시 "https"로 시작해야 합니다. AMO(Mozilla Add-Ons)를 통하지 않고 독자적으로 버전을 관리하려고 할 때 사용합니다.

유효한 Gecko 버전도 참조해 보세요.^[각주:3]

부가기능 ID 형식

부가기능 ID는 반드시 아래 형식 중 하나를 따라야 합니다.

• GUID
• 이메일 주소와 비슷한 형태의 문자열: (예시) extensionname@example.org

문자열 형태의 형식은 쉽게 만들거나 복제할 수 있습니다. 여기에 실제 이메일 주소를 사용하면 스팸 메일을 받는 등의 부작용이 있을 수 있으니 주의하세요.

예를 들어 다음과 같이 쓸 수 있습니다.

"id": "extensionname@example.org"

"id": "{daf44bf7-a45e-4450-979c-91cf07434c3d}"

Microsoft Edge 속성

주의: Edge 전용 속성을 manifest 파일에 추가하면 Firefox 버전 69 이상에서 설치를 차단하는 오류가 발생할 수 있습니다.

Microsoft Edge는 edge라는 이름의 하위 키를 사용하며 다음과 같은 속성을 가지고 있습니다.

browser_action_next_to_addressbar

Boolean 형태의 값으로 브라우저 툴바의 어디에 위치할지를 결정합니다.

• true 값이면 browser_action.default_area 속성이 navbar로 설정됩니다.
• false 값이면 browser_action.default_area 속성이 menupanel로 설정됩니다.

Safari 속성

주의: Safari 전용 속성을 manifest 파일에 추가하면 Firefox 버전 69 이상에서 설치를 차단하는 오류가 발생할 수 있습니다.

Safari는 safari라는 이름의 하위 키를 사용하며 다음과 같은 속성을 가지고 있습니다.

strict_min_version

부가기능에서 지원할 Safari의 최소 버전을 설정합니다.

strict_max_version

부가기능에서 지원할 Safari의 최대 버전을 설정합니다.

예시

모든 가능한 속성을 이용한 예시입니다. 일반적으로 대부분의 부가기능은 strict_max_version이나 update_url 속성을 사용하지 않습니다.

"browser_specific_settings": {
  "gecko": {
    "id": "addon@example.com",
    "strict_min_version": "42.0",
    "strict_max_version": "50.*",
    "update_url": "https://example.com/updates.json"
  },
  "edge": {
    "browser_action_next_to_addressbar": true
  },
  "safari": {
    "strict_min_version": "14",
    "strict_max_version": "20"
  }
}

브라우저 호환성

원본 문서를 참조하세요.

마지막 수정 일자: 2020년 12월 18일(원본) / 2021년 1월 23일(번역본)

1. 역자 주: 사실상 "Firefox" [본문으로]
2. 역자 주: 모든 버전을 뜻합니다. [본문으로]
3. 역자 주: 아마 strict_min/max_version에 속해야 할 내용인데 update_url 항목이 추가되면서 여기로 온 것 같습니다. [본문으로]