[ iOS/Git 시행착오 ] Push된 Info.plist를 .gitignore에 할당하기

 

 

👩‍💻배경👩‍💻

프로젝트를 진행하다보면 토큰 등 개인 정보를 사용해야 하는 경우가 많다. Local 저장소에서만 작업하는 경우에는 개인 정보 보호에 대해 크게 신경 쓸 필요가 없지만, Github과 같은 원격 저장소를 사용하는 경우에는 주의가 필요하다. 만약 미처 신경 쓰지 못하고 개인 정보를 원격 저장소에 올리게 된다면 해킹의 대상이 될 수 있다.

그리고 bundle을 사용하면 코드도 깔끔해지고 데이터 사용도 편리해서 중요한 데이터를 번들로 관리하면 좋다. 이와 같은 이유로 중요한 정보들을 Info.plist 넣고 이 plist 파일을 .gitignore에 추가하려 했다

 

 

 

 

.gitignore에 파일 추가하기

.gitignore에 파일을 추가하는 것은 정말 간단하다. .gitignore 파일을 열고 원하는 파일의 경로를 할당해주면 된다. 또는 특정 확장자를 가진 모든 파일을 추가하고 싶다면 아래와 같이 확장자명만 적어줄 수도 있다.

특정 파일만 추가하기	현재 딕렉토리의 하위 디렉토리명/디렉토리명/파일명
확장자명으로 추가하기	*.확장자명
현재 디렉토리의 하위 파일 추가	파일명

 

하지만 나는 Info.plist 파일을 commit하고 원격 저장소로 Push까지 했기 때문에 그저 .gitignore에 추가하는 것만으로는 해결되지 않는다. 이 정보를 이미 알고 있었고 해본 적이 있기 때문에 해당 작업이 빠르게 끝날 것이라 생각했다. 

 

먼저 gitignore에 Info.plist를 넣어준 후 아래의 명령어를 터미널에 입력했다. 여기서 첫 번째 실수가 발생했다. 이 실수는 내가 문제의 원인을 알게 되었을 때 설명하겠다.

이 명령어는 Local 저장소와 원격 저장소 모두 해당 파일을 삭제하는 방법으로, Local 저장소에서 프로젝트를 계속 작업을 할 예정이면 사용하지 않는 것이 좋다. 나는 다시 Info.plist를 생성하는 방법을 생각하고 사용했는데, 결과적으로 오류가 발생하고 더 헤매게 되었다.

git rm Info.plist
git commit -m "커밋 메세지"

 

 

 

 

첫 번째 오류: Multiple commends produce ~

이렇게 파일을 삭제한 뒤 프로젝트에 들어와 Info.plist를 재생성한 뒤 삭제 전 미리 HTML 형식으로 복사해두었던 파일을 붙여넣었다. 붙여넣기를 할 때 Xcode-SourceControl-commit 창에 뜬 Info.plist를 사용해 붙여넣기했는데, 만약 Info.plist 파일이 .gitignore에 잘 추가되었다면 그곳에 뜨지 않았을 것이다. 당시도 이상하다고 생각했지만 Local이라 그런가보다 생각했다. 아무튼 그렇게 붙여넣기를 완료한 뒤 build를 했는데 오류가 발생했다.

* Multiple commends produce 중복된 파일 경로 ~

 

 

Info.plist를 삭제하고 재생성하여 따로 저장해둔 Info.plist를 붙여넣기 한 과정에서 파일이 중복되었다.  그래서 터미널을 사용해 오류 메세지가 알려주는 파일 경로로 들어가 Info.plist를 삭제했다. 하지만 그래도 같은 오류가 발생해 열심히 구글링을 해본 결과보니 Target-Build Phases-Copy Bundle Resources에서 Info.plist를 삭제해주면 해결되는 문제였다.

 

그대로 PR을 보내고 마무리 하려 했다. PR를 완료하기 전 꼼꼼히 파일을 보고 있는데 Info.Plist가 너무 잘 보였다. 여기서 잘못된 것을 알게 되어 다시 터미널로 돌아왔다. 다른 명령어를 사용하면 되지 않을까 생각해서 구글링해서 새로운 방법을 찾았다. 이 방법은 파일들의 캐시를 삭제해 commit하여 push하는 방법이다. 후에 이 명령어를 다시 사용하기 때문에 그때 무슨 명령어인지 정리하겠다.

 

열심히 캐시를 지우고 push해봐도 Info.plist는 여전히 보였다. 지금 올리려는 데이터도 그다지 중요한 데이터를 아니였으며 브랜치의 커밋 목록이 점점 지저분해지는 것 같아 일단 PR을 보내고 새로운 브랜치를 생성하여 해결하기로 결정했다.

 

 

 

gitignore 말고 .gitignore 😩

PR을 완료하고 develop 브랜치로 병합까지 완료한 후 Github 원격 저장소를 확인해 보았다. 뭐가 문제였는지 정말 단번에 알아차렸다. 하나만 있어야하는 gitignore가 두 개였다. 두 개의 차이는 그저 점 하나 차이였다. 

문제는 터미널에서 발생했다. 나는 보통 파일을 편집하거나 열어볼 때 터미널을 주로 이용하는데, vi 명령어를 사용할 경우 해당 파일이 있으면 열고 없으면 새로 생성해서 열어준다. 그래서 점을 뺀 gitignore로 잘못 파일명을 적었지만 그 이름으로된 파일이 생성된 것이다.

vi gitignore

 

그래서 새 브랜치를 만든 후 가장 먼저 gitignore 파일을 삭제했다. 그리고 Info.plistfmf .gitignore에 추가했다.

vi .gitignore

 

마지막으로 Push된 기존 Info.plist 파일을 내려주기 위해 아까 사용해서 캐시 삭제 명령어를 사용했다.

git rm -r --cached
git add .
git commit -m "커밋 메세지"
git push origin 브랜치명

 

PR과 develop 브랜치 병합까지 마무리하고 Github 저장소를 확인해보니 원하는 대로 Info.plist가 더이상 보이지 않았다. 그렇게 마무리가 된 줄 알았는데 develop 브랜치를 Local 저장소로 Pull 받아보니 Info.plist 파일이 아예 사라져 있었다.

 

 

 

두 번째 오류: Build Target

사라진 Info.plist 파일을 다시 만드는 건 직접에도 해결했기 때문에 문제가 없을 줄 알았다. 하지만 이번에 좀 다른 오류가 발생했다. 아쉽게도 오류를 기록해두지 않아 어떤 오류였는지 남길 수 없지만 Build Target과 관련한 오류였으며 XCBuildConfiguration이 일치하지 않는다?라는 오류였다. 오류 메세지를 파악해보니 Info.plist와 Target간의 연결이 끊어진 것 같았다. 하지만 정말 어떻게 연결해야하는지 알 수 없어 이전에 push한 브랜치를 Local로 불러와 일일이 비교했다. 그러면서 Info.plist와 Custom iOS Target Properties의 값이 서로 같다는 것을 알게 되었다. 오류가 난 브랜치의 프로젝트를 확인해보니 역시나 두 곳의 값이 달랐다.

 

이 차이점을 발견한 후 제발 됐으면 하는 마음으로 옛날 브랜치에서 property를 하나씩 복사해 각각 Info.plist와 Custom iOS Target Properties로 붙여넣었다. 작업을 완료하니 오류는 없어졌고 기기에서도 앱이 잘 작동했다.😮‍💨

둘이 왜 연결되는지 잘 모르겠다. 왜 두 개로 나뉘는걸까..? 어느 블로그에서 아래와 같은 글을 보았다. 이유는 아직 모르겠지만 내 해결 방법이 맞는 방법이었던 것 같다.

<Info.plist Is Missing in Xcode 13 — Here’s How To Get It Back 참고>
먼저 Xcode는 자동적으로 Custom iOS Targer Properties와 반동화기화되는 Info.plist 생성한다. 그후 당신을 위해 Xcode는 그 둘을 병합한다.

 

 

 

마무리

위에서 말했던 오류말고도 오류를 해결하면서 계속 다양한 오류들을 만났다. 정말 정말 그만두고 싶었지만 항상 그렇듯 꼭 해결하겠다고 다짐하며 오류 메세지 분석과 구글링, 그리고 비교하여 해결했다!!!

오늘 이 시행착오를 겪으면서 깨닫게 된 점이 있다면... .gitignore은 프로젝트 만들자마자 설정하자..! 만약 그렇게 못했다고 하면 파일을 삭제하지 말고 캐시를 삭제하자! 

iOS 운영체제도, 통합개발환경인 Xcode도, 언어인 Swift도 개발 관련한 모든 건 너무 어려운 것 같다... 개발자 지망생은 운다🫠

 

 

 

 

 

 

 

 

 

Target

Info.plist Is Missing in Xcode 13 — Here’s How To Get It Back