Linux용 AssetRipper: 다운로드 및 실행 가이드

어떤 Linux용 AssetRipper 빌드를 다운로드할까요?

Linux용 AssetRipper는 두 프로세서 계열로 배포됩니다. Intel 또는 AMD를 사용하는 대부분의 데스크톱, 노트북, 가상 머신에서는 x64를 선택합니다. Raspberry Pi 계열 보드, ARM 서버 또는 아키텍처가 aarch64로 표시되는 Linux 장치에서는 ARM64를 선택하세요. Ubuntu, Debian, Fedora, Arch 같은 배포판 이름만으로 아카이브를 결정할 수는 없습니다.

다운로드 전에 uname -m을 실행하세요. x86_64는 x64, aarch64 또는 arm64는 ARM64에 해당합니다. 공식 2.0.0 메타데이터는 AssetRipper_linux_x64.tar.xz를 29.4 MB, AssetRipper_linux_arm64.tar.xz를 26.2 MB로 기록합니다. 이 환경에서는 ARM64 직접 범위 확인에 성공했지만 x64 CDN 확인은 시간 초과되어 공식 릴리스 페이지 대체 경로를 유지합니다.

Linux에 AssetRipper 설치하기

Linux 설치는 보통 패키지 관리자를 이용하는 방식이 아니라 아카이브 압축 해제 방식입니다. 릴리스에는 실행 파일과 함께 사용할 네이티브 라이브러리가 들어 있으므로 전체 폴더를 그대로 유지하세요. 예를 들어 ~/Applications/AssetRipper/2.0.0처럼 직접 관리할 수 있는 위치에 저장하고, 압축 미리보기에서 파일 하나만 실행하거나 라이브러리를 다른 곳으로 옮기지 마세요.

새 대상 폴더를 만들고 tar와 xz를 이해하는 도구로 tar.xz 아카이브를 압축 해제한 뒤 실행 전에 결과를 확인하세요. 완전히 해제하면 AssetRipper 바이너리와 릴리스에 포함된 파일이 같은 폴더에 있어야 합니다. 파일 관리자가 확장자를 숨긴다면 터미널에서 실제 파일 이름과 실행 권한을 확인하세요.

터미널에서 AssetRipper 바이너리 실행하기

압축 해제 폴더로 이동한 뒤 실제 AssetRipper 바이너리 이름을 실행하세요. Linux는 보통 현재 폴더에서 실행 파일을 자동으로 찾지 않으므로 ./ 접두사가 중요합니다. 셸에 Permission denied가 표시되면 의도적으로 다운로드한 공식 파일에 실행 권한을 추가하고 같은 폴더에서 다시 실행하세요.

처음부터 sudo를 사용하지 마세요. root로 실행하면 파일 소유자가 바뀌고 일반적인 권한 실수를 숨기며 출력 결과를 나중에 확인하기 어려워질 수 있습니다. 짧은 로컬 경로를 사용하고 첫 실행 동안 터미널을 열어 라이브러리, 화면, 실행 상태에 대한 메시지를 기록하세요. X11 또는 Wayland 그래픽 세션 문제는 Unity 데이터를 분석할 수 있는지와 별개의 문제입니다.

• 기본 창이 나타나거나 유용한 오류가 표시될 때까지 터미널을 열어 둡니다.
• 아키텍처 불일치가 의심되면 file ./AssetRipper와 uname -m을 사용합니다.
• 불확실한 릴리스 출처를 해결하려고 무작위 타사 바이너리를 설치하지 않습니다.
• 여러 조건을 동시에 바꾸기 전에 명령, 경로, 그래픽 세션과 정확한 오류를 기록합니다.

cd ~/Applications/AssetRipper/2.0.0 && chmod +x AssetRipper && ./AssetRipper

Linux 권한 및 라이브러리 오류 해결하기

Linux 실행 메시지는 파일이 로드되지 않았다는 메시지와 다른 경계를 가리키는 경우가 많습니다. Permission denied는 보통 실행 비트나 접근할 수 없는 폴더와 관련됩니다. No such file or directory는 압축 해제가 완료되지 않았거나 경로가 틀렸거나, 애플리케이션 파일이 보이더라도 네이티브 로더 종속성이 없다는 뜻일 수 있습니다.

바이너리는 시작되지만 창이 나타나지 않으면 그래픽 데스크톱 세션과 사용할 수 있는 display가 있는지 확인하세요. 그래픽 전달이 없는 SSH 셸에서 실행하는지도 살펴보세요. 창이 열렸는데 AssetRipper가 파일을 찾지 못한다면 권한을 계속 바꾸지 말고 선택한 폴더 수준, 파일 종류, Unity 버전 단서, 암호화, 압축, 종속성을 확인하세요.

• CDN으로 다운로드나 파일 이름을 확인할 수 없으면 공식 릴리스 페이지를 사용합니다.
• 같은 압축 해제 폴더에 서로 다른 AssetRipper 버전의 파일을 섞지 않습니다.
• 그래픽 세션이 없는 문제를 AssetRipper 분석 실패로 혼동하지 않습니다.
• 공유하기 전에 가장 유용한 터미널 오류만 남기고 개인 경로를 삭제합니다.

내보내기 전에 작은 Unity 입력 테스트하기

AssetRipper가 실행되면 첫 입력을 통제된 호환성 테스트로 취급하세요. 소유했거나 검사 권한이 있는 직렬화 Unity 파일, 에셋 번들 또는 작은 프로젝트 폴더 하나를 사용합니다. 처음부터 전체 게임 디렉터리를 읽으면 플랫폼 권한, 누락된 종속성, 지원되지 않는 데이터와 큰 메모리 요청이 하나의 혼란스러운 결과에 섞일 수 있습니다.

새 출력 폴더를 선택하고 원본 입력은 수정하지 않습니다. 가장 단순한 내보내기 모드로 시작해 생성된 파일을 확인한 다음, 결과에서 종속성이 보일 때만 관련 리소스를 추가하세요. Linux에서 실행된다고 해서 Unity 버전, 압축, 암호화, 사용자 지정 패키징, 셰이더, 머티리얼, 누락된 번들의 제한이 없어지는 것은 아닙니다.

기준 테스트에서는 일반적인 Linux 경로를 사용하세요. 공백이 있는 경로는 따옴표로 감싸고, 흐름이 작동하기 전에는 보호되거나 동기화된 폴더를 피합니다. 아카이브 이름, 아키텍처, 입력 형식, 출력 위치와 경고를 기록하면 다음에 Linux, Unity 또는 문제 해결 중 어느 안내를 읽어야 할지 판단하기 쉽습니다.

• 권한이 있는 입력만 사용하고 원본 복사본을 그대로 유지합니다.
• AssetRipper 2.0.0, Linux 아키텍처, 배포판과 정확한 경로를 기록합니다.
• 파일이 없으면 폴더 수준을 확인하고 더 작은 파일 또는 번들을 테스트합니다.
• 텍스처나 머티리얼이 없으면 내보내기가 손상되었다고 하기 전에 관련 리소스를 찾습니다.

오류를 보고하기 전 Linux 확인 목록

이슈를 열기 전에 실행 실패와 로드 또는 내보내기 실패를 구분하세요. 실행 실패는 애플리케이션이 정상 창을 표시하기 전에 발생하며 아카이브 선택, 압축 해제, 실행 권한, 네이티브 라이브러리 또는 그래픽 세션과 관련됩니다. 로드 실패는 실행 후 발생하며 선택한 경로, Unity 데이터, 종속성 또는 분석기 지원과 관련됩니다.

유용한 Linux 보고서는 짧지만 재현 가능해야 합니다. 버전, uname -m 결과, 배포판, 아카이브 이름, 압축 해제 위치, 정확한 명령, 창이 열렸는지 여부, 입력 형식, 출력 모드와 문제를 설명하는 가장 작은 경고를 포함하세요. 로그나 이미지를 게시하기 전에 사용자 이름, 프로젝트 이름과 개인 경로를 제거합니다.

• 배포판 이름으로 추측하지 말고 x86_64 또는 aarch64에 맞는지 확인합니다.
• 전체 폴더가 압축 해제되었고 바이너리가 실행 가능한지 확인합니다.
• 쓰기 가능한 데스크톱 경로에서 실행하고 비교를 위해 원본 아카이브를 보관합니다.
• 큰 디렉터리를 선택하기 전에 권한이 있는 작은 Unity 입력을 테스트합니다.
• 문제가 실행 전, 로드 중, 내보내기 중 언제 발생했는지 기록합니다.
• 직접 파일이나 미러를 확인할 수 없으면 공식 릴리스 페이지를 연결합니다.

uname -m && file ./AssetRipper