Plugins ko KR

플러그인

ASF는 런타임 중 로드할 수 있는 사용자 지정 플러그인을 지원합니다. 플러그인을 사용하면 사용자 지정 명령어 추가, 사용자 지정 거래 로직, 혹은 서드파티 서비스 및 API와의 전체 통합 등을 통해 ASF의 동작을 커스터마이징할 수 있습니다.

이 페이지에서는 사용자 관점에서 ASF 플러그인에 대해 설명합니다 - 설명, 사용법 등을 다룹니다. 개발자 관점에서 보고 싶으시다면 대신 **여기**로 이동하세요.

---

사용법

ASF는 ASF 폴더 내의 plugins 디렉터리에서 플러그인을 로드합니다. 사용하고자 하는 각 플러그인마다 전용 디렉터리를 유지하는 것이 권장 방식입니다(플러그인 자동 업데이트 기능에서는 필수가 됩니다). 이 디렉터리는 플러그인 이름을 기반으로 할 수 있으며, 예를 들어 MyPlugin과 같이 만들 수 있습니다. 이렇게 하면 최종적으로 plugins/MyPlugin과 같은 트리 구조가 됩니다. 마지막으로, 플러그인의 모든 바이너리 파일을 해당 전용 폴더 안에 넣으면, ASF가 재시작 후 이를 올바르게 인식하고 사용합니다.

일반적으로 플러그인 개발자는 바이너리가 포함된 zip 파일 형태로 플러그인을 배포합니다. 즉, 해당 zip 파일을 plugins 디렉터리 내의 전용 하위 디렉터리에 압축 해제해야 합니다.

플러그인이 정상적으로 로드되면, 로그에 해당 플러그인의 이름과 버전이 표시됩니다. 사용하기로 결정한 플러그인과 관련해 질문, 문제, 사용법 등이 있다면 해당 플러그인 개발자에게 문의해야 합니다.

몇 가지 주요 플러그인은 저희 서드파티 섹션에서 확인하실 수 있습니다.

ASF 플러그인은 악성일 수 있다는 점에 유의하세요. 위 서드파티 섹션에 소개된 것이라 하더라도, 항상 신뢰할 수 있는 개발자가 만든 플러그인을 사용하고 있는지 확인해야 합니다. 사용자 지정 플러그인을 사용하기로 결정하면, ASF 개발자는 더 이상 (악성코드가 없다거나 VAC-free 여부 등) ASF의 일반적인 안전성을 보장할 수 없습니다. 플러그인은 한 번 로드되면 ASF 프로세스에 대한 완전한 제어권을 갖게 된다는 점을 이해해야 합니다. 이로 인해 사용자 지정 플러그인을 사용하는 설정은 더 이상 순정(vanilla) ASF 코드로 실행되는 것이 아니므로, 저희가 지원해드릴 수 없습니다.

---

호환성

플러그인의 복잡도, 범위, 그 밖의 여러 요인에 따라, 일반적으로 권장되는 OS별(OS-specific) 버전 대신 제네릭(generic) ASF 버전을 사용해야 하는 경우가 충분히 있을 수 있습니다. 이는 OS별 버전에는 ASF 자체에 필요한 핵심 기능만 포함되어 있기 때문입니다. 여러분의 플러그인이 ASF의 주요 범위를 벗어나는 부분을 필요로 할 경우, 축소된(trimmed) OS별 빌드와 호환되지 않을 수 있습니다.

일반적으로 서드파티 플러그인을 사용할 때는 최대한의 호환성을 위해 ASF 제네릭 버전을 사용하는 것을 권장합니다. 다만 모든 플러그인이 이를 필요로 하는 것은 아니므로, 제네릭 ASF 버전이 필요한지 여부는 사용 중인 플러그인의 안내 정보를 참고하시기 바랍니다.

---

자동 업데이트

ASF에는 플러그인 자동 업데이트를 위한 내장 메커니즘이 있습니다. 이 기능이 동작하려면, 먼저 사용 중인 플러그인이 해당 메커니즘을 **지원**해야 합니다. 자동 업데이트를 지원하는 플러그인을 로드한 경우, ASF는 플러그인 초기화 과정에서 이를 로그에 적절히 표시합니다. 예를 들어 "plugin has been disabled from automatic updates"(플러그인이 자동 업데이트에서 비활성화되었습니다) 또는 "plugin has been registered and enabled for automatic updates"(플러그인이 등록되어 자동 업데이트가 활성화되었습니다)와 같이 표시됩니다.

기본적으로 사용자 지정 플러그인의 자동 업데이트는 보안상의 이유로 비활성화되어 있습니다. PluginsUpdateList 및/또는 **PluginsUpdateMode**를 사용해 자동 업데이트를 설정에서 구성할 수 있으며, 자세한 내용은 해당 설정 속성의 설명을 참고하시기 바랍니다. 또한 ASF 업데이트와 마찬가지로, 자동 업데이트를 비활성화해둔 채 updateplugins **명령어**를 사용해 필요할 때마다 수동으로 업데이트하는 방식도 선택할 수 있습니다.

두 방식 모두 프로세스에 로드한 사용자 지정 플러그인을 전부, 일부, 또는 전혀 업데이트하지 않도록 선택할 수 있게 해줍니다.