---
title: 임베디드 Linux 환경 설정
product: Unity Editor
version: '6000.0'
latest_version: '7000.0'
status: This page documents version 6000.0. The latest version is 7000.0.
canonical: https://docs.unity.com/ko-kr/engine/6000.0/manual/platform-specific/embedded-systems/embedded-linux/get-started/environment-setup
latest_url: https://docs.unity.com/ko-kr/engine/7000.0/manual/platform-specific/embedded-systems/embedded-linux/get-started/environment-setup.md
last_updated: 2026-10-30
generated_at: 2026-11-19T23:22:46.585Z
locale: ko-kr
---

# 임베디드 Linux 환경 설정

> 환경을 설정하여 임베디드 Linux 개발합니다.

환경을 설정하여 임베디드 Linux 사용하여 개발합니다.

임베디드 Linux Unity 애플리케이션을 생성하려면 먼저 임베디드 Linux 지원하도록 Unity 프로젝트 설정해야 합니다. 임베디드 Linux 지원하려면 Unity 프로젝트 특정 패키지와 종속성이 필요합니다.

> **Note:**
>
> 환경을 설정하려면 먼저 Embedded Linux 플랫폼 패키지를 설치해야 합니다. 자세한 내용은 [내장 Linux용 플랫폼 패키지 설치](/engine/6000.0/manual/platform-specific/embedded-systems/embedded-linux/get-started/install-editor.md)를 참조하십시오.

## 툴체인 및 SDK 패키지 설치##install-the-toolchain-and-sdk-packages

Unity 새 프로젝트를 생성한 후에는 운영체제와 타겟 아키텍처에 대해 다음 툴체인 및 SDK 패키지를 설치해야 합니다. 임베디드 Linux 툴체인 및 SDK용 Unity 패키지를 설치하려면 [이름으로 UPM 패키지 설치](/engine/6000.0/manual/packages-list/managing-packages-window/upm-ui-actions/upm-ui-quick.md)를 참조하십시오.

> **Note:**
>
> sysroot 및 툴체인 패키지를 설치할 때 기본 sysroot 패키지 `com.unity.sysroot`가 종속성으로 설치됩니다. 기본 sysroot 패키지에는 종속된 sysroot 패키지와 툴체인 패키지 간에 공유되는 공통 코드가 포함되어 있습니다.

### 툴체인 패키지##toolchain-packages

| **Operating system** | --**package**                                    |
| -------------------- | ------------------------------------------------ |
| **Windows**          | `com.unity.toolchain.win-x86_64-embeddedlinux`   |
| **Windows(Arm64)**   | `com.unity.toolchain.win-arm64-embeddedlinux`    |
| **macOS**            | `com.unity.toolchain.macos-x86_64-embeddedlinux` |
| **macOS(Arm64)**     | `com.unity.toolchain.macos-arm64-embeddedlinux`  |
| **Linux**            | `com.unity.toolchain.linux-x86_64-embeddedlinux` |

툴체인 패키지를 설치할 때 원하는 임베디드 Linux 플랫폼을 기반으로 적절한 타겟 아키텍처 sysroot 패키지를 설치해야 합니다. 예를 들어 `com.unity.toolchain.linux-x86_64-embeddedlinux` 툴체인 패키지를 설치할 때 해당하는 타겟 아키텍처 sysroot 패키지를 설치해야 합니다. 예를 들어 x86\_64 타겟 아키텍처의 경우 sysroot 패키지 `com.unity.sdk.embeddedlinux-x86_64`를 사용합니다. 지원되는 타겟 아키텍처의 sysroot 패키지 전체 목록은 다음 표에 나와 있습니다.

### SDK 패키지##sdk-packages

| **타겟 아키텍처** | --**package**                         |
| ----------- | ------------------------------------- |
| **aarch64** | `com.unity.sdk.embeddedlinux-aarch64` |
| **x86\_64** | `com.unity.sdk.embeddedlinux-x86_64`  |
| **arm32**   | `com.unity.sdk.embeddedlinux-arm32`   |
| **x86**     | `com.unity.sdk.embeddedlinux-x86`     |

sysroot 패키지를 설치할 때는 의도된 타겟 플랫폼에 맞는 툴체인 패키지를 설치해야 합니다. 예를 들어 `com.unity.sdk.embeddedlinux-x86_64` sysroot 패키지를 설치할 때 해당하는 `com.unity.toolchain.linux-x86_64-embeddedlinux` 툴체인 패키지를 설치해야 합니다.

패키지를 설치한 후 패키지 관리자 창에 임베디드 Linux 설치된 툴체인 및 SDK 패키지가 표시됩니다.


**Package Manager window with Embedded Linux toolchain package:**
![](/api/media?file=/engine/6000.0/media/images/embedded-linux-proj-setup-1.png)

### 자동 패키지 설치##automated-packages-installation

**빌드 프로파일** 창에서 필요한 임베디드 Linux 패키지를 자동으로 설치할 수도 있습니다.

패키지의 자동 설치를 시작하려면 다음 단계를 따르십시오.

1. Unity 메인 메뉴에서 **파일** > **빌드 프로필**으로 이동합니다.
2. **빌드 프로파일** 창에서 **빌드 프로파일 추가**를 선택하여 **플랫폼 브라우저** 창을 엽니다.
3. **Platform Browser** 창에서 **Embedded Linux**를 선택한 다음 **Add Build Profile**을 클릭합니다.
4. Unity 메인 메뉴에서 **편집** > Editor로 이동합니다.

Unity 에디터에서 기본적으로 **설치 툴체인 패키지 자동** 옵션이 활성화된 경우, 설치된 아키텍처에 필요한 툴체인 및 SDK와 같은 패키지가 자동으로 설치됩니다. 패키지 설치 프로세스가 완료되면 프로젝트 설정의 **툴체인 관리(Embedded Linux)** 탭에서 설치된 패키지를 확인할 수 있습니다.


**Installed packages in Toolchain Management (Embedded Linux):**
![](/api/media?file=/engine/6000.0/media/images/embedded-linux-proj-setup-3.png)

패키지를 자동으로 설치하는 옵션이 비활성화된 경우, **툴체인 관리(내장 Linux)** 탭으로 이동하여 **설치 sdk 및 툴체인 패키지**를 클릭할 수 있습니다.

패키지를 설치한 후 패키지 관리자 창에 임베디드 Linux 설치된 모든 툴체인 패키지 리스트가 표시됩니다.


**Install sdk and toolchain packages button in Toolchain Management (Embedded Linux):**
![](/api/media?file=/engine/6000.0/media/images/embedded-linux-proj-setup-2.png)

## 종속성##dependencies

Unity 올바르게 실행하려면 임베디드 Linux 직접 및 간접 종속성을 제공해야 합니다.

### 직접 종속성##direct-dependencies

애플리케이션 시작 시 직접 종속성이 로드됩니다.

* `libm.so.6`
* `libgcc_s.so.1`
* `libpthread.so.0`
* `libc.so.6`
* `libdl.so.2`
* `librt.so.1`

### 간접 종속성##indirect-dependencies

간접 종속성은 애플리케이션 런타임 중 필요한 경우 공유 라이브러리로 로드됩니다.

| **Type**      | **종속성**                                                                                                                         |
| ------------- | ------------------------------------------------------------------------------------------------------------------------------- |
| **Audio**     | `libpulse-simple.so.0` `libpulse.so.0` `libesd.so.0` `libasound.so or libasound.so.2`                                           |
| **Wayland**   | `libwayland-client.so.0` `libwayland-egl.so.1` `libwayland-cursor.so.0` `libxkbcommon.so.0`                                     |
| **X11**       | `libX11.so.6` `libXext.so.6` `libXcursor.so.1` `libXinerama.so.1` `libXi.so.6` `libXrandr.so.2` `libXss.so.1` `libXxf86vm.so.1` |
| **OpenGL ES** | `libEGL.so.1` `libGLESv2.so.2`                                                                                                  |
| **Vulkan**    | `libvulkan.so.1`                                                                                                                |
| **Devices**   | `libudev.so.1`                                                                                                                  |

## 추가 리소스##additional-resources

* [시스템 요구 사항](/engine/6000.0/manual/get-started/install-and-upgrade/getting-started-installing-unity/system-requirements.md)
* [내장형 Linux용 개발](/engine/6000.0/manual/platform-specific/embedded-systems/embedded-linux/develop.md)
* [내장형 플랫폼을 위한 최소한의 URP 설정 만들기](/engine/6000.0/manual/platform-specific/embedded-systems/embedded-platforms-minimal-urp-setup.md)
