# 설치
이 가이드는 Adobe After Effects용 LottieFiles 플러그인을 설치하고, 처음 열어 보고, 실행에 필요한 스크립트 권한을 허용하는 과정을 안내합니다.

## 시작하기 전에

- **Adobe After Effects CC 2015 이상**(AE 호스트 버전 13.0+ 필요) {/* [needs review] 최소 AE 버전 확인 */}
- **LottieFiles 계정** — 무료입니다. 설치 후 로그인해 애니메이션을 둘러보고 가져옵니다.
- **macOS 또는 Windows** — 플러그인은 두 플랫폼을 모두 지원합니다. {/* [needs review] 크로스 플랫폼 지원 확인 */}

## 설치 방법 선택

플러그인은 세 곳에서 받을 수 있습니다. 하나만 선택하면 되며 결과는 같습니다.

### 옵션 A — Adobe Exchange(Creative Cloud Marketplace)

1. Adobe Creative Cloud 데스크톱 앱을 엽니다.
2. **Marketplace**로 이동해 "LottieFiles for After Effects"를 검색합니다.
3. **Install**을 클릭합니다.

Creative Cloud가 플러그인을 설치합니다. 아래 **플러그인 열기**로 건너뛰세요.

### 옵션 B — LottieFiles 웹사이트

1. [lottiefiles.com/plugins/after-effects](https://lottiefiles.com/plugins/after-effects)에 방문합니다.
2. **Download**를 클릭합니다.
3. `.zxp` 파일을 받게 됩니다. 다음 섹션의 ZXP Installer로 설치합니다.

### 옵션 C — aescripts

1. [aescripts.com](https://aescripts.com)의 LottieFiles 플러그인 페이지에 방문합니다. {/* [needs review] 정확한 aescripts URL 확인 */}
2. `.zip` 파일을 다운로드하고 압축을 풉니다. 폴더 안에 `.zxp` 파일이 들어 있습니다.
3. 다음 섹션의 ZXP Installer로 `.zxp`를 설치합니다.

## ZXP Installer로 설치하기(옵션 B와 C)

ZXP Installer는 aescripts에서 제공하는 무료 유틸리티로, `.zxp` 확장 프로그램을 Adobe 앱에 설치합니다.

1. 아직 없다면 [ZXP Installer](https://aescripts.com/learn/zxp-installer/)를 다운로드해 설치합니다.
2. After Effects가 실행 중이면 종료합니다.
3. ZXP Installer를 열고 애플리케이션 드롭다운에서 **Adobe After Effects**를 선택합니다.
4. `.zxp` 파일을 ZXP Installer 창으로 드래그합니다.
5. 성공 확인 메시지가 뜰 때까지 기다립니다. 이제 플러그인이 설치되었습니다.

{
  // TEMP_IMAGE_HIDDEN: 임시 릴리스에서는 숨김. 시각 QA 때 이 소스 위치에 이미지를 복원하세요.
  false ? (

  <Image
        src="/images/screenshots/ae-getting-started-zxp-installer.webp"
        alt="ZXP Installer with Adobe After Effects selected and the ZXP drop area highlighted"
        caption="After Effects를 선택하고 .zxp 파일을 ZXP Installer에 놓아 플러그인을 설치합니다"
        zoom
        variant="default"
      />
  ) : null
}

## After Effects에서 플러그인 열기

1. After Effects를 엽니다.
2. **Window > Extensions > LottieFiles**로 이동합니다.

LottieFiles 패널이 열립니다. 워크스페이스 설정에 따라 도킹되어 있거나 떠 있는 창으로 표시됩니다.

{
  // TEMP_IMAGE_HIDDEN: 임시 릴리스에서는 숨김. 시각 QA 때 이 소스 위치에 이미지를 복원하세요.
  false ? (

  <Image
        src="/images/screenshots/ae-getting-started-window-menu.webp"
        alt="After Effects Window menu with Extensions > LottieFiles highlighted"
        caption="Window > Extensions에서 플러그인을 엽니다"
        zoom
        variant="default"
      />
  ) : null
}

## 첫 설정 — 스크립트의 파일 쓰기 허용

처음 플러그인을 열면 스크립트 권한 관련 안내가 보일 수 있습니다. 한 번만 해결하면 이후부터 플러그인이 정상 작동합니다.

1. After Effects에서 **Edit > Preferences > Scripts & Expressions**로 이동합니다(macOS: **After Effects > Settings > Scripts & Expressions**).
2. **Allow Scripts to Write Files and Access Network**를 체크합니다.
3. **OK**를 클릭합니다.
4. LottieFiles 패널로 돌아와 **Reload**를 클릭합니다.

{
  // TEMP_IMAGE_HIDDEN: 임시 릴리스에서는 숨김. 시각 QA 때 이 소스 위치에 이미지를 복원하세요.
  false ? (

  <Image
        src="/images/screenshots/ae-getting-started-scripts-preference.webp"
        alt="After Effects Scripts and Expressions preferences with Allow Scripts to Write Files and Access Network highlighted"
        caption="After Effects 환경설정에서 스크립트와 네트워크 접근을 허용합니다"
        zoom
        variant="default"
      />
  ) : null
}

## 결과 확인

After Effects 안에 LottieFiles 패널이 보여야 합니다. 로그인 화면이 보이거나, 이미 로그인했다면 워크스페이스가 표시됩니다. 여기서 애니메이션을 둘러보고, 컴포지션으로 가져오고, After Effects 작업물을 Lottie로 내보낼 수 있습니다.

<span id="troubleshooting" />

## 문제 해결

- **Window > Extensions 아래에 플러그인이 보이지 않음** — `.zxp` 설치 전에 After Effects를 완전히 종료했는지 확인하세요. 필요하면 ZXP Installer로 다시 설치합니다.
- **"Allow Scripts" 체크박스가 비활성화됨** — After Effects를 종료했다가 다시 엽니다. Windows에서는 처음 한 번 After Effects를 관리자 권한으로 열면 해결될 수 있습니다. {/* [needs review] Windows 관리자 실행 우회 방법 확인 */}
- **플러그인은 로드되지만 빈 화면이 표시됨** — 인터넷 연결을 확인하세요. LottieFiles 워크스페이스를 불러오려면 플러그인에 네트워크 접근이 필요합니다.