|
|
리포지터리에 있는 프로젝트를 가지고 작업을 하려면, 그 리포지터리에서 프로젝트의 작업본을 얻어야 합니다. 여러분은 파일을 수정하고, 추가하고 삭제하는 것과 같은 작업을 작업본에 대해서 합니다. 수정을 다 했으면 그것을 리포지터리에 제출 혹은 commit하거나 그 수정한 것이 잘못되거나 필요없게되면 그냥 그것을 버릴 수 있습니다.
이 문서에서는 리포지터리에 있는 프로젝트에 대해서 작업을 하기전에 작업 환경을 어떻게 세팅하는지에 대해서 설명합니다. 또한 SCM 시스템으로 관리되는 파일들에 주로 하는 작업과 리포지터리나 작업본에 영향을 끼치는 작업에 대해서 설명합니다.
작업 환경 세팅하기
작업본에 대해서 SCM 작업 수행하기
리포지터리에 관련된 작업하기
충돌 해결하기
리포지터리에 있는 프로젝트를 가지고 작업을 하려면, 그것의 로컬 카피를 가지고 있어야 합니다. 이 로컬에 있는 작업본에 대해서 수정을 가하는 것이며, 그것을 나중에 리포지터리에 submit하는 것입니다.
SCM 시스템은 작업본을 얻기 위한 두가지 방법을 제공합니다.
사용하시는 SCM 시스템의 참조하셔서 그 시스템이 어떤 모드를 사용하는지 확인하십시오.
수정하고자 하는 프로젝트의 로컬 카피를 가져온 후에, 그 프로젝트를 열고 Xcode가 사용할 SCM 시스템을 선택하십시오. 이렇게 하는 이유는 SCM 시스템이 인증하는 단위가 사용자 이름이나 암호같이 개발자당 적용되는 것이기 때문입니다. 이것은 참고로 프로젝트.xcode 번들에 저장되지 않습니다. 그런 정보는 <username>.pbxuser 파일에 저장됩니다. 프로젝트를 여는 한 개발자당 그런 화일이 하나씩 있습니다. 아무튼 반드시 프로젝트가 그런 SCM 시스템을 반드시 사용하도록 세팅해야 합니다. Xcode는 한 프로젝트가 이미 사용던 SCM 시스템을 다른 것으로 교체하는 것을 지원하지는 않습니다. Xcode에서 SCM 시스템을 사용하시려면 Xcode 도움말을 참조하시기 바랍니다.
이 섹션에선 프로젝트에서 SCM 시스템에 의해서 관리되는 파일들에 대한 작업에 대한 설명을 하고 있습니다.
SCM을 사용하여 작업하는 것은 기존에 프로젝트 화일을 가지고 작업하는 것과 별반 다르지 않습니다. 대부분의 경우엔 보통 하던 대로 소스 파일, 리소스 파일, nib들 그리고 기타 화일들을 수정하면 됩니다. 하지만 화일을 에디팅 할 때에는, SCM 시스템에 따라 두가지의 모드가 있습니다.
변경한 사항은 리포지터리에 commit을 했을때만 리포지터리에 수정된 내용이 반영된다는 것을 항상 염두에 두십시오.
화일을 프로젝트의 작업본에 추가하려면, 평상시에 하듯이 하시면 됩니다. 그리고 나서 리포지터리에 그 화일을 즉시 추가하거나 혹은 프로젝트를 계속 수정하고 다 끝난후에 리포지터리에 commit을 하는 방법이 있습니다.
리퍼지터리에 화일을 추가하고 싶은를 Xcode에 알려주는 방법은 Xcode 도움말을 참고하십시오.
작업본에서 화일을 삭제하고 싶으면, 프로젝트에서 그 화일을 삭제하십시오. 이 작업본에 대한 변경사항이 commit되면, 그 파일은 비로소 리포지터리에서 삭제될 것입니다.
파일 이름을 바꾸려면 이전 이름을 가진 파일을 새 이름의 파일로 카피해야 합니다. 그리고 리포지터리에서 이전의 이름으로 된 파일을 지우십시오. “Removing Files”을 보십시오. ) 그리고 새 이름의 파일을 추가하십시오.(“Adding Files”을 참조 하십시오.)
실수로 잘못 수정하여 그것을 되돌리고 싶다면 그렇게 할 수 있습니다. 즉 이전에 check-out한 버젼의 파일로 현재 잘못수정된 작업본을 교체하는 것입니다. 자세한 것은Xcode 도움말을 참조하십시오.
이번 섹션에서는 리포지터리에 어떤 정보를 보내고 받는 것에 대해서 설명을 합니다.
작업을 해 나가다가 보면, 다른 개발자들이 여러분이 억세스해야 할 리포지터리에 변경을 가할 수 있습니다. 혹은 여러분은 개발 팀 동료들이 하는 변경사항을 반영하는 최신 버젼의 파일을 항상 가지고 있고 싶을 수 있습니다. 또한 수정 사항을 commit하기 전에, 여러분이 가지고 있는 작업본을, 프로젝트가 성공적으로 빌드되고 수행될 수 있도록, 항상 최신 버젼으로 해 놓는 좋은 습관을 가지고 있을 수 있습니다.
Xcode는 작업본에 있는 파일이 언제 업데이트 되어야 할지 알려 줍니다. 즉 언제 리포지터리에 더 새 버젼의 화일이 존재하기 시작했는지 알려 줍니다. 화일 상태 코드에 대한 자세한 정보와 작업본을 업데이트 하는 방법은 Xcode 도움말을 참고 하시기 바랍니다.
작업본을 업데이트 할때에는, 화일들간에 충돌사항이 있는지 Xcode가 알려주는 경우도 있을 겁니다. 이런 충돌을 작업본에 대해서 추가 작업을 하기 전에 미리 해결을 해 주어야 합니다. 이에 대한 자세한 설명은 “충돌 해결하기”을 참조하시기 바랍니다.
작업본에 있는 화일을 가지고 작업하다보면, 가장 최근의 checkout이나 갱신 후에 그 화일들에 도대체 무슨 변경을 가했는지 보고 싶을 수 있습니다. 여러분의 개발 조직은 어쩌면 변경 사항이 commit되기 전에 그 변경 사항을 재검하는 것을 요구할 지도 모릅니다. 여러분은 작업본에 가한 변경 사항을 볼 수만 있는게 아닙니다. 리포지터리에 그 화일이 추가된 이후에 변경된 모든 사항을 볼 수 있습니다.
두 버젼의 동일 화일간에 존재하는 다른 점을 보는 두가지 방법이 있습니다.
화일 버젼 비교에 대해서는 Xcode 도움말을 참고하십시오.
commit하는 것은 작업본에 가한 변경사항을 리포지터리에 있는 프로젝트에 적용하는 것입니다. 얼마나 자주 commit를 하느냐는 여러분이 일하시는 조직의 개발 전략에 따라 달라질 수 있습니다. 예를 들어 하루에 한두번 commit하는 것은 대체적으로 리포지터리가 개발중인 코드의 최신 버젼을 저장하고 있을 수 있게합니다. 아무리 리포지터리를 기반으로 하는 개발이 코드의 안정성을 확보하는데 들어가야 할 노력을 최소화 할 수는 있지만 그래도 여전히 불안정할 수 있습니다. 반면에 뜸하거나 정규적으로 commit을 하면 개발팀 동료들이 가하는 변경사항에 상관없이 작업을 할 수 있게 합니다. 또 정규적으로 commit를 할때는 그 로 인한 문제를 해결하는데 필요한 시간이 자주 commit을 할때와 비교해서 오래 걸립니다.
변경 사항를 commit할 때, log 메시지를 기입할 수 있는 다이얼로그 박스가 뜹니다. 이 메시지는 가능한한 정확해야합니다. 그래야 여러분이나 다른 동료개발자들이 당신이 왜 수정을 했는지, 그리고 그 의도가 무엇인지 알 수가 있습니다. 특히나 디버깅할때는 더더욱 그러합니다. 예를 들어, 어떤 코드에 해결해야할 필요가 있는 문제가 있다고 합시다. 그리고 그 문제의 원인이 되는 어떤 특정 라인을 알아냈다고 합시다. 누가 그 라인을 작성했는가와 왜 그렇게 했는가를 안다면, 그 라인을 안심하고 삭제할 수 있던가 아니면 수정을 할 수 있게 해줍니다.
여러분의 개발 조직이 문제를 추적하는 시스템을 사용하고 있다면, log 메시지에 문제 식별 번호를 포함하는 것이 좋습니다. 또한 왜 수정을 했는가에 대해 정리해 놓는 것이 필요합니다. 예를 들어, 수정을 가했을때 예견되는 프로그램의 기능이나 작동을 기술하는 것이 그런 것입니다. 만약 버그를 해결하기 위해서 몇몇 화일을 수정하면, 그것들모두 함께 commit해야합니다. 그런 경우에, 기입해 놓은 log 메시지는 그 수정 사항 전체에 관련된 것이 될 것입니다.
어떻게 수정 사항을 commit해야 하는지는 Xcode 도움말을 참고하십시오.
충돌은 여러분이 작업본에서 수정한 내용이, 여러분이 check-out을 하거나 갱신을 한 후에 다른 사람이 리포지터리에 commit한 내용을 덮어쓰게 될 경우에 발생합니다. SCM 상태 코드를 이용해서 언제 코드에 충돌이 생기는지 Xcode환경에서 확인할 수 있습니다. (자세한 것은 Xcode 도움말을 참고하십시오. )
작업본을 수정하기 전에 충돌을 반드시 해결해야만 합니다. 여러분 스스로 해결하거나, 여러분의 코드와 충돌을 일으키는 코드를 작성한 개발자와 같이 상의를 하는 것이 좋을 것입니다. 어떻게 할지는 충돌하는 코드의 크기와 중요도에 따라 달라질 것입니다. 충돌을 하결하려면 다음과 같이 할 수 있습니다.
충돌을 해결한 후에, 작업본을 계속 수정하거나, 그 다른 개발자들에게 여러분이 수정한 것이 그들이 하는 작업과 밀접하게 관련이 있음을 알려주기 위해 리포지터리에 그 화일을 commit할 수 있습니다.
© 2004 Apple Computer, Inc. All Rights Reserved. (Last updated: 2004-06-28) 번역 : 박종암 (Translated by JongAm Park)