Download the latest source code from GitHub - XIYO/asuswrt-merlin.ng-kr GitHub Wiki

소개

환영합니다! 이 안내서는 Asuswrt-Merlin 소스 코드의 최신 버전을 얻는 방법과 패치 및 컴파일을 위한 안정된 코드의 버전을 제공합니다.

용기를 내주세요! 자체 펌웨어를 컴파일할 때 리스크가 존재합니다. 이를 진행하는 것은 여러분의 책임이며, 무언가 잘못될 경우 펌웨어 제작자는 여러분의 컴파일된 펌웨어를 지원하지 않을 것입니다. 여러분은 Asus 복구 유틸리티를 이용하여 복구 모드에서 펌웨어를 접근하고 플래시하는 방법에 익숙해져야 합니다. 여러분의 펌웨어가 빌드되지 않을 수도 있고, 플래시되지 않을 수도 있으며, 플래시되지만 라우터를 부팅하지 못하게 할 수도 있으며, 플래시되고 부팅되더라도 올바르지 않거나 예상치 못한 방식으로 작동할 수도 있습니다. 컴퓨터가 갑자기 발화할 수도 있으며, 여러분이 갑자기 발화할 수도 있으며, 세상이 끝날 수도 있습니다.## 준비 사항 ##

참고: 이 안내서는 Linux 배포판에 대한 기본적인 작동 지식을 가정합니다. Linux 배포판을 설치하고 접근하는 방법, 터미널에 접근하는 방법 및 배포판의 패키지 관리자를 통해 패키지를 설치하는 방법을 알아야 합니다.

참고: 이 안내서는 펌웨어를 빌드하기 위한 어떠한 사전 준비 사항도 다루지 않습니다 - 여러분의 배포판에 따라 추가 패키지를 설치해야 할 수 있습니다. 필요한 추가 패키지에 대한 정보는 펌웨어 빌드 안내서에서 확인하세요.

컴파일을 위한 소스 코드를 다운로드하려면 다음이 필요합니다:

• Linux 기반 운영 환경 (Linux를 실행하는 전용 컴퓨터 또는 VMware 또는 VirtualBox를 사용한 가상 머신).
• git 분산 버전 관리 시스템 (일반적으로 여러분의 Linux 배포판의 패키지 관리자에 포함되어 있음)
• 적어도 10GB의 빈 하드 드라이브 공간 (v378.55 기준)## 소스 코드 다운로드 ##

터미널을 열고 원하는 디렉토리로 이동하세요. Asuswrt-Merlin을 위해 새 디렉토리를 만들 필요는 없습니다. git을 통해 저장소를 복제하면 디렉토리가 자동으로 생성됩니다.

이제 저장소를 복제하세요: git clone git://github.com/RMerl/asuswrt-merlin.git.

이 단계는 컴퓨터의 인터넷 연결 속도에 따라 시간이 걸릴 수 있습니다. 다운로드되는 데이터는 약 1.5GiB입니다 (v378.55 기준). 잠시 휴식을 취하고 커피를 마시고 다리를 펴세요.

(Master 브랜치만 필요한 경우 다음 명령으로 짧은 시간 안에 복제할 수 있습니다: git clone git://github.com/RMerl/asuswrt-merlin.ng.git --depth=1 --single-branch)

이 명령의 출력은 다음과 같을 것입니다:

build@asuswrt-merlin:~$ git clone git://github.com/RMerl/asuswrt-merlin.ng.git
Cloning into asuswrt-merlin...
remote: Counting objects: 76989, done.
remote: Compressing objects: 100% (54069/54069), done.
remote: Total 76989 (delta 20537), reused 76676 (delta 20231)
Receiving objects: 100% (76989/76989), 483.79 MiB | 3.10 MiB/s, done.
Resolving objects: 100% (20537/20537), done.
build@asuswrt-merlin:~$

이제 새로 생성된 asuswrt-merlin 디렉토리로 이동하세요: cd asuswrt-merlin

build@asuswrt-merlin:~$ cd asuswrt-merlin/
build@asuswrt-merlin:~/asuswrt-merlin$

이 시점에서 GitHub 저장소의 master 브랜치를 복제했습니다. master 브랜치에는 git에 커밋되고 GitHub에 푸시된 최신 코드가 포함되어 있습니다. 이 코드를 사용하려면 여기에서 멈추고 펌웨어 빌드를 계속할 수 있습니다.

참고: master 브랜치에서 빌드하려는 경우 진행 중인 기능 및 코드 병합이 언제든지 포함될 수 있음을 염두에 두세요. 이는 펌웨어가 성공적으로 빌드되지 않을 수 있거나, 컴파일된 펌웨어 이미지가 예상대로 작동하지 않을 수 있음을 의미합니다.

그러나 더 안정적인 코드 기반에서 작업하고 빌드하려면 계속하세요!

3.0.0.4.270.24 BETA 3 릴리스부터 GitHub에서는 '태그'를 사용합니다. 태그는 중요한 이력 지점(릴리스)으로 간주됩니다. 우리는 코드 기반이 그 시점에서 어떻게 되었는지 보기 위해 태그로 전환할 수 있습니다.

git을 사용하여 사용 가능한 태그를 확인할 수 있습니다: git tag -l

build@asuswrt-merlin:~/asuswrt-merlin$ git tag -l
3.0.0.4.270.24-BETA3
build@asuswrt-merlin:~/asuswrt-merlin$

현재 작성 시점에서는 3.0.0.4.270.24-BETA3 빌드만 사용 가능하므로 해당 시점으로 전환하겠습니다. 사용하려는 태그에 대한 다음 명령에서 3.0.0.4.270.24-BETA3를 대체해야 합니다: git checkout 3.0.0.4.270.24-BETA3

build@asuswrt-merlin:~/asuswrt-merlin$ git checkout 3.0.0.4.270.24-BETA3
Note: checking out '3.0.0.4.270.24-BETA3'.

You are in 'detached HEAD' state. You can look around, make experimental
changes and commit them, and you can discard any commits you make in this
state without impacting any branches by performing another checkout.

If you want to create a new branch to retain commits you create, you may
do so (now or later) by using -b with the checkout command again. Example:

  git checkout -b new_branch_name

HEAD is now at 3dc2b4c... populateCache() now handled by the lease XML parsing
build@asuswrt-merlin:~/asuswrt-merlin$

이 명령에 대한 git의 긴 메시지에 대해서는 걱정하지 마세요. 그냥 과거로 돌아갔다는 것을 알려주는 것뿐입니다!

이 시점에서 원하는 태그로 돌아와서 패치 또는 펌웨어 빌드를 계속할 수 있습니다.

언제든지 마스터 브랜치로 돌아가서 작업하려면 다음 명령을 사용할 수 있습니다: git checkout master (마스터 브랜치가 최신 코드입니다!)

build@asuswrt-merlin:~/asuswrt-merlin$ git checkout master
Previous HEAD position was 3dc2b4c... populateCache() now handled by the lease XML parsing
Switched to branch 'master'
build@asuswrt-merlin:~/asuswrt-merlin$## 로컬 저장소 업데이트 ##

RMerlin이 계속해서 Asuswrt-Merlin을 개선하고 업데이트할 때, 이전에 다운로드한 코드는 빠르게 오래된 상태가 될 수 있습니다. 하지만 걱정하지 마세요! 전체 복제 과정을 다시 수행할 필요가 없습니다! 그냥 git pull 명령을 사용하세요:

소스 코드를 변경한 후 git pull을 실행하면, 마스터 브랜치가 여러분이 변경한 파일에도 변경 사항이 있으면 병합 충돌이 발생할 수 있습니다. 이러한 병합 충돌은 이 문서의 범위를 벗어납니다. 병합 충돌을 해결하는 방법에 대한 문서는 공식 git 문서에서 찾을 수 있습니다.

build@asuswrt-merlin:~/asuswrt-merlin$ git pull
remote: Counting objects: 329, done.
remote: Compressing objects: 100% (258/258), done.
remote: Total 318 (delta 60), reused 312 (delta 54)
Receiving objects: 100% (318/318), 469.80 KiB | 455 KiB/s, done.
Resolving deltas: 100% (60/60), completed with 11 local objects.
From git://github.com/RMerl/asuswrt-merlin
 * [new branch]      nfs        -> origin/nfs
Already up-to-date.
build@asuswrt-merlin:~/asuswrt-merlin$

이제 최신 상태입니다! 이 특정 경우에는 우리가 저장소를 복제한 시점과 첫 번째 git pull을 수행한 시점 사이에 'nfs'라는 새 브랜치가 생성되었습니다. 원한다면 이 브랜치로 전환할 수 있습니다 (git checkout nfs), 그리고 git pull 작업 중에도 새로운 태그가 저장소에서 검색됩니다.

만약 git pull을 실행할 때 이미 여러분의 저장소가 GitHub의 저장소와 최신 상태라면, git은 단순히 이미 최신 상태임을 알려줄 것입니다.

build@asuswrt-merlin:~/asuswrt-merlin$ git pull
Already up-to-date.
build@asuswrt-merlin:~/asuswrt-merlin$## 결론 ##

여기까지 입니다! 이 가이드를 통해 Asuswrt-Merlin의 최신 소스 코드를 얻는 데 도움이 되었을 것입니다. 이제 소스 코드를 빌드하기 위한 다른 위키 가이드를 참고할 수 있습니다!