GitHub 오픈소스 탐험

안녕하세요! 오늘은 핸드헬드 리눅스 기반 디바이스에서 다양한 포트를 쉽게 설치할 수 있도록 돕는 오픈소스 프로젝트인 PortMaster를 소개합니다. 이 프로젝트는 특히 AmberELEC, ArkOS, Rocknix, RetroOZ, TheRA, EmuELEC와 같은 운영체제를 사용하는 사용자들에게 유용합니다. PortMaster는 단순히 포트를 설치하는 것뿐만 아니라, 기존 OS 라이브러리를 변경하지 않고도 다양한 포트를 관리할 수 있는 방법을 제공합니다. 그럼 PortMaster의 주요 기능과 사용법을 알아보겠습니다!

PortMaster의 주요 기능과 특징

1. 간편한 포트 관리

PortMaster는 300개 이상의 포트를 지원합니다. 기존에는 zip 파일로 관리되던 포트들이 새로운 구조로 변경되어, 각 포트가 독립적으로 관리되며, 필요한 라이브러리도 포트 폴더 내에 포함됩니다. 이를 통해 포트 간의 라이브러리 충돌을 방지하고, 업데이트 시에도 문제를 최소화할 수 있습니다.

2. 새로운 포트 구조

새로운 구조에서는 각 포트가 개별 폴더에 저장됩니다. 각 포트는 port.json, 스크린샷(screenshot.jpg/png), README, 포트 스크립트 등이 포함되어 있어, 관리와 사용이 훨씬 용이해졌습니다. 예를 들어, 포트 이름 규칙에 따라 이름을 정하면, 시스템에서 이를 자동으로 인식하여 처리합니다.

3. 기여 방법

PortMaster는 오픈소스 프로젝트이기 때문에, 누구나 기능 추가나 버그 수정을 위해 PR을 제출할 수 있습니다. 포크 후에 디렉토리 구조를 맞추고, 필요한 스크립트를 실행하여 포트를 추가하면 됩니다.

PortMaster 설치 및 사용법

1. 설치하기

PortMaster를 사용하기 위해서는 Git과 Python이 필요합니다. 아래의 명령어로 PortMaster를 클론합니다:

git clone https://github.com/PortsMaster/PortMaster-New.git
cd PortMaster-New

2. 레포 준비하기

클론한 레포에서 다음 스크립트를 실행하여 필요한 파일을 다운로드합니다:

tools/prepare_repo.sh

3. 포트 추가하기

새로운 포트를 추가하려면 ports/ 디렉토리에 새로운 폴더를 만들고, 그 안에 필요한 파일들을 배치합니다. 예를 들어, 아래와 같은 구조로 설정할 수 있습니다:

ports/
  └── my_new_port/
      ├── port.json
      ├── screenshot.jpg
      ├── README.md
      ├── MyNewPort.sh

4. 포트 검증하기

포트가 제대로 구성되었는지 확인하려면 다음 명령어를 실행합니다:

python3 tools/build_release.py --do-check

5. 포트 빌드 및 배포

포트의 모든 요소가 정상이라면, 포트를 빌드하여 zip 파일로 만들 수 있습니다:

python3 tools/build_release.py

이렇게 생성된 zip 파일은 releases/ 폴더에 저장됩니다.

PortMaster의 활용 시나리오

PortMaster는 다양한 핸드헬드 기기에서 게임이나 애플리케이션을 설치하고 관리하는 데 특히 유용합니다. 예를 들어, RetroOZ를 사용하는 사용자라면, PortMaster를 통해 수많은 게임 포트를 손쉽게 관리하고 업데이트할 수 있습니다. 게임 개발자나 커뮤니티 기여자들은 자신이 만든 포트를 추가하여, 다른 사용자와 공유할 수 있는 기회를 가지게 됩니다.

비슷한 도구와 PortMaster 비교

비슷한 도구로는 RetroArch와 LaunchBox가 있습니다. RetroArch는 다양한 에뮬레이터를 하나의 플랫폼에서 사용할 수 있도록 돕지만, PortMaster는 특정 핸드헬드 디바이스에 최적화된 포트 관리를 제공합니다. 또한, PortMaster는 기존 운영체제의 라이브러리를 변경하지 않으므로, 시스템 안정성이 더 높습니다.

다양한 핸드헬드 디바이스에서 포트를 쉽게 관리할 수 있는 도구, PortMaster