<?xml version="1.0" encoding="UTF-8"?><rss xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns:content="http://purl.org/rss/1.0/modules/content/" xmlns:atom="http://www.w3.org/2005/Atom" version="2.0" xmlns:cc="http://cyber.law.harvard.edu/rss/creativeCommonsRssModule.html">
    <channel>
        <title><![CDATA[Stories by Wooseong Kim on Medium]]></title>
        <description><![CDATA[Stories by Wooseong Kim on Medium]]></description>
        <link>https://medium.com/@innocarpe?source=rss-6761161ec96f------2</link>
        <image>
            <url>https://cdn-images-1.medium.com/fit/c/150/150/1*oGk4WFF6hYif6K5mRkpNOA.jpeg</url>
            <title>Stories by Wooseong Kim on Medium</title>
            <link>https://medium.com/@innocarpe?source=rss-6761161ec96f------2</link>
        </image>
        <generator>Medium</generator>
        <lastBuildDate>Thu, 19 Nov 2026 10:38:17 GMT</lastBuildDate>
        <atom:link href="https://medium.com/@innocarpe/feed" rel="self" type="application/rss+xml"/>
        <webMaster><![CDATA[yourfriends@medium.com]]></webMaster>
        <atom:link href="http://medium.superfeedr.com/" rel="hub"/>
        <item>
            <title><![CDATA[SwiftLint 캐싱을 통한 Incremental Build 최적화하기]]></title>
            <link>https://medium.com/29cm/swiftlint-%EC%BA%90%EC%8B%B1%EC%9D%84-%ED%86%B5%ED%95%9C-incremental-build-%EC%B5%9C%EC%A0%81%ED%99%94%ED%95%98%EA%B8%B0-c68c8fe7ae96?source=rss-6761161ec96f------2</link>
            <guid isPermaLink="false">https://medium.com/p/c68c8fe7ae96</guid>
            <category><![CDATA[development]]></category>
            <category><![CDATA[mobile]]></category>
            <category><![CDATA[ios]]></category>
            <category><![CDATA[swiftlint]]></category>
            <category><![CDATA[29cm]]></category>
            <dc:creator><![CDATA[Wooseong Kim]]></dc:creator>
            <pubDate>Wed, 22 Jan 2025 07:18:29 GMT</pubDate>
            <atom:updated>2025-01-22T07:22:41.487Z</atom:updated>
            <content:encoded><![CDATA[<figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*LAW2WThL9SkHoA4zNvG79g.jpeg" /><figcaption>generated by <a href="https://openai.com/index/dall-e/">DALL·E</a></figcaption></figure><p>안녕하세요, 29CM 모바일팀의 iOS 개발자 김우성입니다. 이번 글에서는 SwiftLint 와 관련된 개선 작업을 통해 팀의 생산성을 향상시키고자 했던 내용을 다뤄보려고 합니다.</p><p>iOS 팀에서는 대부분 SwiftLint 를 사용하실 텐데요, 저희 팀에선 모듈화를 해나가는 과정에서 SwiftLint 로 인해 증분 빌드 시간이 계속해서 영향을 받는 것을 발견해 이를 개선해 증분 빌드 속도를 개선했습니다.</p><p>이번 글에선 기존 SwiftLint 를 사용하던 방식에서의 이슈를 먼저 소개드리고, 이를 어떻게 개선했고 그로 인한 사이드 이펙트는 무엇이었으며, 최종적으론 어떻게 마무리했는지에 대해 말씀드리려고 합니다.</p><h3>SwiftLint 사용과 증분 빌드 이슈</h3><h4><strong>SwiftLint의 일반적인 사용</strong></h4><p>SwiftLint는 iOS 프로젝트에서 코드 스타일과 품질을 유지하는 데 필수적인 도구입니다. 일반적으로 Xcode Build Phase 에 Run Script Phase 명령어를 추가하여 사용하며, .swiftlint.yml 설정 파일을 통해 검사 규칙을 커스터마이징하는 것이 일반적입니다.</p><p>저희 29CM iOS팀 역시 <a href="https://github.com/realm/SwiftLint">SwiftLint 레포지토리</a> 에서 권장하는 설정과 함께 팀의 코드 스타일 가이드라인을 반영하여 SwiftLint를 사용하고 있었습니다.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*9AnFXDEGW-8oiS_KNrm_zw.png" /><figcaption>스크립트를 만들어 Path 설정, GitHub 대응, 타입별 swiftlint.yml 분기 등을 처리합니다.</figcaption></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*sJoZQZTTf-xjT5ggaxgeqA.png" /><figcaption><a href="https://github.com/realm/SwiftLint">https://github.com/realm/SwiftLint</a></figcaption></figure><h4>SwiftLint 로 인한 증분 빌드 영향</h4><p>하지만 이렇게 설정한 경우 SwiftLint 는 컴파일 시마다 전체 코드베이스를 검사하기 때문에 증분 빌드에서 항상 일정 시간이 소요되는 문제가 있었습니다.</p><p>특히, 모듈화된 프로젝트에서는 모듈의 수가 늘어날수록 각 모듈에 대한 SwiftLint 실행이 따로 일어나기에모듈 개수가 적을 때에 비해서 시간이 더 증가하게 됩니다. 저희는 모듈화를 지속적으로 해나가는 팀이었기에, 팀의 일상적인 코딩 생산성을 위해 이 이슈를 개선할 필요가 있다고 판단했습니다.</p><p>빌드 속도는 팀의 생산성과 직결되는 중요 요소라는 생각과, 증분 빌드는 일정적인 코딩에서 사용하는 방식이라 클린 빌드에 비해 더 중요하다는 생각이 있었기 때문이기도 합니다.</p><p>맥북 성능마다 시간의 차이는 있었지만 SwiftLint 로 인한 순수 소요시간이 <strong>M1~M3 Pro 맥북 기준으로 15초~30초 정도였습니다.</strong> 이는 빌드가 완료된 상태에서 코드 수정 없이 바로 다시 빌드를 수행할 때의 시간으로, 빌드 로그를 보면 모든 모듈에 대해 SwiftLint 가 도는 데 소요된 시간임을 확인할 수 있었습니다.</p><h3>SwiftLint 로컬 캐싱 구현</h3><p>앞서 언급한 현상을 개선하기 위해 SwiftLint 를 캐싱할 방법이 없을지 고민했습니다. 그러던 와중 Run script 쪽에서 Based on dependency analysis 라는 옵션을 발견했는데요, 이는 불필요한 스크립트 수행을 막기 위한 옵션으로 Input File Lists 의 변화가 발생할 때에만 스크립트를 수행하도록 만들어 줍니다.</p><p>이 옵션을 활용한다면 필요한 시점에 필요한 곳에서만 SwiftLint 를 돌릴 수 있지 않을까 싶었는데요, 테스트를 해 보니 해당 옵션은 Input File Lists 가 존재해야만 Phase 를 돌릴 수 있었기에 모든 타겟들에 대해 Input/Output 파일을 적절하게 만들어 줄 필요가 있었습니다.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*z_NoJYrxE0btwNwT0YFNWA.png" /><figcaption>SwiftLint Phase</figcaption></figure><p>위와 같은 형태가 되도록 해야 하는데, 두 가지 기능이 필요했습니다.<br><strong>1. 기준이 되는 최초의 Input File Lists 파일 (xcfilelist)<br>2. 파일이 수정될 때 해당 모듈의 SwiftLint 를 새로 돌릴 수 있도록 Input File List 갱신</strong></p><p>이를 위해 xcfilelist 를 갱신해 주는 스크립트를 우선 개발한 뒤, 위 두 가지 상황에서 공통으로 사용할 수 있도록 개발을 진행했습니다.</p><p>아래의 스크립트는 <strong>특정 타겟을 기준으로 master 브랜치와 현재 작업 디텍토리를 비교해 현 타겟 내 변경사항이 있다면 이 목록을 xcfilelist 에 기록</strong>하도록 해 주는 스크립트입니다.</p><pre>#!/bin/bash<br><br># Script 캐싱을 위한 xcfilelist 와 Output 정의<br>SWIFTLINT_XCFILELIST_FILE=&quot;${FOLDER_PATH}/${TARGET_NAME}_swiftlint.xcfilelist&quot;<br>SWIFTLINT_OUTPUT_FILE=&quot;${FOLDER_PATH}/${TARGET_NAME}_swiftlint_static_output&quot;<br><br>…<br><br># 현재의 파일 변경사항을 Git Diff 파일과 xcfilelist 파일에 새로 저장<br>echo &quot;Generating new SwiftLint xcfilelist&quot;<br>echo &quot;$ALL_MODIFIED_SWIFT_FILES&quot; &gt; &quot;$SWIFTLINT_XCFILELIST_FILE&quot;<br># Xcode 가 매번 스크립트를 실행하지 않도록 빈 Output 파일 생성<br>touch &quot;${SWIFTLINT_OUTPUT_FILE}&quot;</pre><p>그리고 이 스크립트를 1번 상황에서 사용할 수 있도록 아래와 같은 스크립트를 같이 개발했습니다. 모든 타겟에 대해 처리를 해주어야 했기에, 최대한의 속도를 위해 CPU 코어 수를 구해 병렬로 스크립트를 돌리도록 만들어 주었습니다.</p><pre>#!/bin/bash<br><br># CPU 코어 수 가져오기<br>CORE_COUNT=$(sysctl -n hw.ncpu)<br><br>…<br><br># 루프 폴더를 기준으로 &#39;Project.swift&#39; 파일이 있는 모든 폴더 리스트<br>PROJECT_FOLDERS=$(find ./ -name &quot;Project.swift&quot; -exec dirname {} \; | sed &#39;s|\.\./||&#39;)<br># 각 폴더에 대해 코어 수 만큼 병렬로 스크립트 실행<br>echo &quot;$PROJECT_FOLDERS&quot; | xargs -I {} -P $CORE_COUNT bash &quot;$PARALLEL_EXECUTION_SCRIPT&quot; &quot;$ABSOLUTE_SCRIPT_FILE_PATH&quot; {}</pre><p>2번 상황은 Scheme 설정에 있는 <strong>Build Pre-actions</strong> 를 활용했습니다. 해당 액션을 통해 특정 타겟 내 변경사항이 있다면, Build 전에 Input File Lists 를 갱신해 주게 됩니다. 그래서 Based on dependency analysis 옵션으로 인해 해당 타겟은 빌드 시 SwiftLint 를 돌려 주게 됩니다.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*0ZlrJzrDVlDqB-iyXQII_w.png" /></figure><p>위 두 가지 방식으로 SwiftLint 를 로컬 캐싱하도록 하여 평소 개발시에는 대부분의 타겟에서 SwiftLint 를 돌리지 않도록 바꾸었는데요, <strong>적용 전 SwiftLint 소요 시간이 15~30초 사이였다면 적용 후에는 1~2초 로 바뀌었습니다.</strong></p><p>큰 차이가 아니라고 볼 수도 있지만, 증분 빌드의 일반적인 소요 시간을 생각해볼 때 매 빌드마다 이만큼의 시간이 줄어드는 건 증분 빌드 속도의 쾌적함에서 생각보다(?) 차이가 있었습니다 😅</p><h3>SwiftLint 로컬 캐싱으로 인한 이슈 및 한계</h3><p>하지만 로컬 캐싱 도입 후 몇몇 파일에서 Lint 체크가 제대로 안 되는 문제가 발생했습니다. 실시간으로 확인하지 않고 xcfilelist 가 바뀔 때마다 SwiftLint 가 돌 다 보니 이로인한 경고나 오류를 발견하는데 시차가 생기는 경우가 종종 있었습니다.</p><p>이로 인해 master 브랜치에 머지된 후 다른 개발자가 경고를 발견하거나, 일정 수 이상 모아서 한 번에 수정하는 PR을 올리는 상황이 발생했습니다. 가끔은 컴파일 오류를 유발하는 린트 오류도 있어서, 급하게 컴파일을 되게 만드는 PR을 올려야 하는 경우도 발생했습니다.</p><p>캐시를 활용하는 이상 감안할 수도 있는 부분이었지만, 문제는 이러한 현상이 일상화되면서 팀 차원에서 린트에 대한 민감도가 점점 줄어드는 현상도 같이 생기게 되었습니다.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*aNOvndgDowB2pJK8heWfiA.png" /><figcaption>열심히 제거했던 흔적들</figcaption></figure><h3>SwiftLint CI 도입</h3><p>일정 기간 캐싱을 활용해본 결과, 린트 해소에 대한 피로감과 린트 민감도 측면에서 앞에서 언급한 이슈를 추가로 개선할 필요가 있었고, 이에 SwiftLint CI 를 추가해 부족한 부분을 커버하고자 했습니다. (작업해 주신 iOS 동료 개발자분께 감사를 🙏)</p><p>CI는 일반적으로 널리 사용되는 <a href="https://github.com/danger/swift">danger-swift</a> 라는 도구를 사용해 GitHub Actions Workflow 로 구축했습니다. Dangerfile.swift 는 대략 아래와 같은 형태입니다. (Workflow 파일은 단순해서 생략했습니다)</p><pre>import Danger<br><br>let danger = Danger()<br><br>...<br><br>let allModifiedFiles = danger.git.modifiedFiles + danger.git.createdFiles<br>let swiftlintPath = &quot;…&quot;<br><br>...<br><br>SwiftLint.lint(<br> .files(otherFiles),<br> inline: true,<br> configFile: &quot;SwiftLint/.swiftlint-danger.yml&quot;,<br> swiftlintPath: .bin(swiftlintPath)<br>)</pre><p>CI는 Build 와 Lint 를 따로 두어서 컴파일 자체가 특별히 문제가 없는지도 확인하면서, Lint CI 에서는 변경된 파일들에 대해서만 SwiftLint 체크를 하도록 해 기존 Workspace 에 린트 오류가 특별히 없다는 전제 앞서 언급한 SwiftLint 캐싱으로 인한 이슈가 더이상 발생하지 않게 되었습니다.</p><p>또한 Build Post-action 과 백그라운드 실행 기능을 활용해 컴파일 완료와 별개로 싱크를 하도록 해 준다면 개발자의 개발 흐름과 무관하게 SwiftLint 캐싱 이슈를 더 보완할 수 있습니다. (프로젝트 빌드 캐싱 유지를 위해 불필요한 xcfilelist 재생성과 변조를 막기 위한 처리는 필요합니다)</p><h3>마치며</h3><p>이번에 소개드린 SwiftLint 로컬 캐싱과 그 영향을 SwiftLint CI 도입으로 해소한 작업들은 iOS 개발자가 일상적으로 가장 많이 하는 활동인 증분 빌드 시간 개선을 통해 팀의 개발 생산성을 향상시키는 데 기여했습니다.</p><p>SwiftLint 가 아니더라도 팀에서 다른 Build Phase 를 사용하시고 있으시다면 이번에 소개 드린 Based on dependency analysis 옵션, xcfilelist, Build Pre-actions등을 활용해 빌드 시간 개선을 시도해볼 수 있으리라 생각합니다.</p><p>오늘 소개드린 내용이 팀 개발 생산성 향상에 관심많은 개발자 분들께 도움이 되셨길 바라면서 이번 글을 마치겠습니다!</p><h3>MUSINSA CAREER</h3><blockquote><strong><em>함께할 동료를 찾습니다.</em></strong></blockquote><blockquote><em>29CM팀은 ‘고객의 더 나은 선택을 돕는다’라는 미션으로 출발했습니다. 우리는 우리만의 방식으로 콘텐츠를 제공하며, 브랜드와 고객 모두에게 대체 불가능한 커머스 플랫폼을 만들어가고 있습니다. 이 미션을 이루기 위해 우리는 흥미로우면서도 복잡한 문제들을 해결하고 있습니다. 만약 우리와 함께 이 문제들을 해결해 보고 싶다면, 주저하지 말고 29CM에 합류하세요!</em></blockquote><blockquote><em>🚀 </em><a href="https://corp.musinsa.com/ko/career/"><em>팀 무신사 채용 페이지</em></a><em> (무신사/29CM 전체 포지션 확인이 가능해요)</em></blockquote><blockquote><em>🚀 </em><a href="https://kr.linkedin.com/company/musinsacom"><em>팀 무신사 테크 소식을 받아보는 링크드인</em></a></blockquote><blockquote><em>🚀 </em><a href="https://medium.com/musinsa-tech"><em>무신사 테크 블로그</em></a></blockquote><blockquote><em>🚀 </em><a href="https://medium.com/29cm"><em>29CM 테크 블로그</em></a></blockquote><blockquote><em>🚀 </em><a href="https://www.youtube.com/@MUSINSATECH"><em>무신사 테크 유튜브 채널</em></a></blockquote><blockquote><em>채용이 완료되면 공고가 닫힐 수 있으니 빠르게 지원해 주세요!</em></blockquote><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=c68c8fe7ae96" width="1" height="1" alt=""><hr><p><a href="https://medium.com/29cm/swiftlint-%EC%BA%90%EC%8B%B1%EC%9D%84-%ED%86%B5%ED%95%9C-incremental-build-%EC%B5%9C%EC%A0%81%ED%99%94%ED%95%98%EA%B8%B0-c68c8fe7ae96">SwiftLint 캐싱을 통한 Incremental Build 최적화하기</a> was originally published in <a href="https://medium.com/29cm">29CM TEAM</a> on Medium, where people are continuing the conversation by highlighting and responding to this story.</p>]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[Trunk-based development, Feature Flag, micro PR 와 함께 주 2회 배포하기]]></title>
            <link>https://medium.com/29cm/trunk-based-development-feature-flag-micro-pr-%EC%99%80-%ED%95%A8%EA%BB%98-%EC%A3%BC-2%ED%9A%8C-%EB%B0%B0%ED%8F%AC%ED%95%98%EA%B8%B0-b703d646d945?source=rss-6761161ec96f------2</link>
            <guid isPermaLink="false">https://medium.com/p/b703d646d945</guid>
            <category><![CDATA[ios]]></category>
            <category><![CDATA[collaboration]]></category>
            <category><![CDATA[feature-flags]]></category>
            <category><![CDATA[mobile]]></category>
            <category><![CDATA[trunk-based-development]]></category>
            <dc:creator><![CDATA[Wooseong Kim]]></dc:creator>
            <pubDate>Tue, 26 Sep 2023 04:27:06 GMT</pubDate>
            <atom:updated>2023-10-19T09:01:10.614Z</atom:updated>
            <content:encoded><![CDATA[<figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*6WxrxLIsf4TSSXYPxgBzFw.png" /><figcaption>illustrated by DALL·E 3</figcaption></figure><p>안녕하세요, 29CM 모바일팀 리드/iOS 개발자 김우성입니다. 지난 글 이후 오랜만에 글을 작성하게 되었는데요, 이번 글에서는 저희 팀이 오랜 기간에 걸쳐 개선해 온 개발 프로세스에 대한 얘기를 해볼까 합니다.</p><p>저희 29CM 모바일팀은 전사적으로 추구하는 업무 문화인 <a href="https://www.29cmcareers.co.kr/4011337b-e213-4a1b-aace-76dc724a850f">29WAY</a> 와 함께 지속적인 팀 성장과 프로세스 개선을 진행해오고 있있는데요, iOS팀에서는 이 목표를 달성하기 위해 지금까지 여러 도구를 도입하거나 프로세스를 시도해 왔었습니다.</p><p>그 중에서도 <strong>Trunk-based development, Feature Flag, micro PR</strong> 라는 세 가지 키워드와 함께 저희가 스쿼드/플랫폼에서 지속적으로 새로운 피쳐를 개발하면서도 주 2회 배포를 진행하는 업무 문화를 만들어 왔는지 소개드리려고 합니다.</p><h3>1. Trunk-based development 와 Feature Flag</h3><p><strong>Trunk-based development</strong> 는 이름에서도 알 수 있듯 모든 개발자가 하나의 코드 브랜치인 ‘trunk’ 에서 작업을 진행하는 방식입니다. 이 방식은 여러 브랜치를 관리하는 복잡함을 줄여주며 지속적인 통합을 통해 코드의 품질과 안정성을 지속적으로 확보할 수 있게 해줍니다. 일반적으로 GitHub Flow 라고도 부릅니다.</p><p>저희 팀은 기존 두 개의 브랜치를 사용하던 Git Flow 에서, TBD 로 넘어오는 결정을 하게 되었는데 이를 위해 필요한 중요 인프라, Feature Flag 를 먼저 도입할 필요가 있었습니다.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*b5o8oBkfz51M31MRWk6MEQ.png" /><figcaption>Git Flow</figcaption></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*lwOU-sn6-iQw6HemomsUbg.png" /><figcaption>GitHub Flow</figcaption></figure><p><strong>Feature Flag </strong>는 사용자에게 보이는 기능을 동적으로 토글할 수 있는 스위치로써, 서비스 중인 앱에 새로운 기능을 추가하거나 변경할 때 그 변경사항을 일부 사용자에게만 보이게 하거나 숨기는 데 사용됩니다. 이를 통해 저희 팀은 새로운 기능의 안정성을 테스트하면서도 실 사용자 환경에서의 피드백을 즉시 받을 수 있게 되었습니다.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*78xBYMHvamMMewWWyQ0Vfg.jpeg" /></figure><p>저희 팀에선 각 Feature Flag 를 생성할 때 각 개발자가 다음과 같은 정보를 기입하도록 했고, 같은 파일 내에서 리스트를 관리하되 각 스쿼드/플랫폼 등 영역을 명시적으로 구분해서 어떤 스쿼드에서 어떤 피쳐들이 플래그로 분기가 되어 있는지 한 눈에 확인할 수 있도록 했습니다.<br>- 플래그 키<br>- 플래그 설명<br>- 피쳐 개발 상태 (개발중 / 카나리 배포 가능 / RC 배포 가능 / 릴리즈 가능 / 개발 중단)<br>- 담당자</p><pre>//<br>// FeatureFlag+List.swift<br>//<br><br>/// A Squad<br>@objc public extension FeatureFlag {<br> static let searchResultAInventoryEnabled = FeatureFlag(<br> key: &quot;searchResultAInventoryEnabled&quot;,<br> verbose: &quot;검색 결과 화면에서 A 인벤토리를 볼 수 있습니다.&quot;,<br> stage: .readyForRelease(targetVersion: &quot;5.79.0&quot;),<br> owner: .personA<br> )<br> static let homeBannerYYExperimentEnabled = FeatureFlag(<br> key: &quot;homeBannerExperimentYEnalbed&quot;,<br> verbose: &quot;홈 배너 YY 실험을 진행합니다.&quot;,<br> stage: .readyForRelease(targetVersion: &quot;5.97.0&quot;),<br> owner: .personA<br> )<br> …<br>}<br><br>/// B Squad<br>@objc public extension FeatureFlag {<br> static let zzProgramEnabled = FeatureFlag(<br> key: &quot;zzProgramEnabled&quot;,<br> verbose: &quot;tt 상황에 zz 프로그램을 표시합니다.&quot;,<br> stage: .readyForRelease(targetVersion: &quot;6.3.1&quot;),<br> owner: .personC<br> )<br>}<br>…<br><br>/// Platform<br>@objc public extension FeatureFlag {<br> static let platformFeatureAEnabled = FeatureFlag(<br> key: &quot;platformFeatureAEnabled&quot;,<br> verbose: &quot;A 피쳐를 표시합니다.&quot;,<br> stage: .readyForRelease(targetVersion: &quot;5.89.0&quot;),<br> owner: .personD<br> )<br>}</pre><h3><strong>2. Google’s changelist author’s guide</strong></h3><p>저희 팀의 사례를 소개하기에 앞서, Google의 사례를 먼저 소개하고자 합니다. Google은 하나의 모노레포에서 수만명이 개발하고 있는 것으로 유명한데요, Google이 지향하는 <strong>Changelist Author’s Guide </strong>는 모노레포를 사용하는 많은 기업들에게 도움을 주는 가이드라인이 되어왔습니다.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*7EQCyHs7-Almm_-rgPeMEA.png" /></figure><p>Google이 지향하는 원칙, 왜 작은 CL을 작성해야 하는가? 를 가볍게 살펴보면 다음과 같습니다:</p><p>- 더 빨리 리뷰 받을 수 있고<br>- 더 철저하게 리뷰 받을 수 있고<br>- 버그를 생산할 가능성이 줄어들고<br>- 혹여 리젝되더라도 버려지는 양이 적고<br>- 머지하기 쉽고<br>- 설계를 잘 하기 쉽고<br>- 리뷰들 간의 블락이 줄어들고<br>- 롤백하기 쉬움</p><p>장점이 참 많죠? 이것 외에 또 중요하게 봐야 하는 점이 그 아래에 있는데요, ‘<strong>리뷰어는 CL이 너무 크다는 단 한 가지의 이유만으로 CL을 리젝할 권한이 있다’</strong>는 점입니다. 이미 크게 만들고 나면 분리하기가 쉽지 않을 수 있기에 처음부터 작은 CL을 작성하도록 권장하고 있습니다.</p><p>이러한 원칙은 저희 29CM 모바일팀이 추구하는 개발 방식과도 일치하는 부분이 많습니다. Google의 철학과 방법론을 참고하면서 오랜 기간에 걸쳐 저희 팀만의 원칙을 만들어 나가고 있는데요, 바로 저희가 <strong>micro PR</strong> 이라고 부르고 있는 협업 방식입니다.</p><h3>3. micro PR</h3><p><strong>micro PR</strong> 은 ‘작은 변경’을 중심으로 한 풀 리퀘스트 방식입니다. 이 방법은 PR의 크기를 최소화하여, 리뷰 과정을 간소화하고 더욱 빠르게 개발을 진행할 수 있게 해줍니다. 단순한 코드 수정부터 복잡한 로직 변경까지, 모든 변경사항을 작은 단위로 관리하면서 전체 코드의 품질을 유지하는 것이 핵심입니다.</p><p>앞서 소개한 TBD와 Feature Flag 의 조합을 통해 micro PR을 작성할 수 있는 인프라가 갖추어졌는데요, 저희 팀에서의 각 피쳐들은 대략 아래와 같은 형태로 개발이 됩니다.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*g7QPGKFR4Y5iEUrOfgcpzw.png" /></figure><p>피쳐를 개발하는 첫 PR 에서, 일반적으로는 로컬 피쳐 플래그와 원격 피쳐 플래그인 Amplitude Flag 를 사용해 이중으로 분기 처리를 합니다. 아래에서 두 번째 PR을 보시면 `빈 추천 메인 화면을 추가합니다.` 라는 PR이 보이실 텐데요, 이런 식으로 실험군을 대상으로 분기 작업을 가장 먼저 해 두게 되면 그 이후의 작업 부터는 각 개발자가 PR를 작성할 때마다 사내 빌드가 정상적으로 아카이브 되도록 보장만 해 준다면 얼마든지 자유롭게 개발을 할 수 있는 환경이 조성되게 됩니다.</p><p>이렇게 micro PR 들이 레포에 모이게 되면 각 개발자들은 집중해서 자신의 개발을 진행하면서도 중간중간 짬이 날 때마다 최소한의 맥락을 가진 PR들을 리뷰하게 되면서 빠르게 리뷰할 수 있는 것들은 빠르게 리뷰 &amp; 머지를 할 수 있게 됩니다. 이는 팀 차원에서 PR의 머지 리드 타임을 줄이고 더 빠른 배포를 할 수 있게 돕습니다. 이러한 PR들을 저희는 저맥락 PR이라 부르기도 합니다.</p><p>위 과정을 통해 설계적/구현적 관점에서 팀에서 좀 더 집중해서 리뷰해야 하는 PR 들만 따로 리뷰할 수 있는 환경이 되어, 구성원이 작업 과정에서 고민이 되었던 코드들은 더 좋은 구현을 위해 팀 차원에서 심도 있게 논의를 하곤 합니다. 기본적으로는 PR 내에서 비동기 커뮤니케이션으로 협업하지만 논의가 길어질 경우에는 페어 프로그래밍을 하기도 하고, iOS 팀 미팅에서 해당 건을 다같이 논의하기도 하면서 각 구성원이 더 좋은 결과물과 코드를 만들 수 있게 서포트를 하곤 합니다.</p><h3>4. 앱을 주 2회 배포한다고?</h3><p>위에서 소개드린 인프라와 팀의 문화가 작년 즈음 어느정도 정착을 되면서 기존 2~3주에 배포하던 프로세스를 주 1회 배포 프로세스로 바꾸게 되었습니다. 이를 위해 앱스토어 제출 프로세스도 대부분 자동화를 하게 되었는데, 이후 1년 정도 주 1회 배포를 계속 유지했지만 최근부터는 29CM 앱 고객에게 더욱 빠르게 가치를 전달하기 위해 모바일팀 내부 논의와 프로덕트 팀 협의를 거쳐 <strong>주 2회 배포</strong> 방식으로 바꾸게 되었습니다.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*OT3tK_Sq7RQBXm_R0w6SbQ.png" /><figcaption>Tim Cook 사장님께서 매 릴리즈 시기마다 친절히 알려주십니다</figcaption></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*Qy71q4-nWaFLUZuMQvb8zA.png" /><figcaption>Federighi 부사장님은 29CM iOS 앱의 배포 상태를 알려주십니다</figcaption></figure><p>이번 글의 제목을 <strong>‘주 2회 배포하기’</strong> 에 포커스하긴 했지만, 결과적으로는 앞서 소개드린 부분이 충분히 팀의 기반으로 자리잡았기 때문에 위와 같은 결정을 할 수 있었습니다. 이러한 프로세스는 TDD 기반으로 일을 하거나 테스트 커버리지를 중시하는 팀이 아닌 이상 일반적으로는 상당히 공격적인 배포 정책으로 인지는 하고 있습니다만, 저희 회사가 추구하는 문화 29WAY 중 <a href="https://www.29cmcareers.co.kr/b1c48fd8-923c-4dd8-b839-a26263be0714"><strong>‘빠른 실행’</strong></a>과 <a href="https://www.29cmcareers.co.kr/0107ff55-2226-46c2-83ed-6399ad78d7e9"><strong>‘고객 집중’</strong></a>을 위해 리스크를 일부 지면서도 더 자주 배포할 수 있는 팀으로 변화하게 되었다고 생각합니다.</p><p>물론 배포를 위한 리소스가 들지 않는 것은 아니기에, Canary/RC/Stable 등 여러 종류의 빌드를 지속적으로 배포하는 Continuous Delivery 를 구축해 두었고, 앱스토어 제출도 간단히 진행할 수 있는 자동화 프로세스를 GitHub Action 기반으로 구축해 두어 모바일 개발자의 부담을 최소화하기 위한 장치도 같이 마련하고 있습니다.</p><h3>5. 앱 안정성도 챙겨야 하지 않나요?</h3><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*VxQBcDdC9gnSMNE8hRUMGQ.png" /></figure><p>저희 팀은 지속되는 피쳐 개발과 인프라 개선, 잦은 배포에도 위와 같이 오랜 기간 높은 Crash-free rate를 유지해오고 있습니다.</p><p>앱 안정성은 주 1회 배포를 할 때부터 지속적으로 팀이 고민해왔던 주제입니다. MAU가 점점 늘어나고 새롭게 개발하는 영역이 늘어나면서 스쿼드에서 배포 전에 미처 챙기지 못했던 엣지 케이스가 발생하거나 하는 경우는 종종 발생했고, 그로 인해 핫픽스를 진행하기도 했습니다.</p><p>하지만 저희가 릴리즈를 제출하기 직전의 RC 빌드에서 주요 피쳐를 검수하는 1-Pager Test를 그 주의 릴리즈 담당자가 간단히 진행한 뒤에 배포를 시작했기 때문에 아직까지는 다행히 Expedite Review 를 애플에 요청해야 하는 상황이 발생한 적은 없었습니다.</p><p>다만 주 2회 릴리즈를 하는 것은 저희 모바일 팀에도 부담이 되는 것은 사실이라, 최근에는 올해에 신설된 QA팀과 협업해 QA Engineering 을 통한 QA 자동화 파이프라인을 구축하고 있습니다. 이 프로세스가 완성되면 저희 모바일팀의 리소스 역시 이전보다 더 줄일 수 있을 것으로 기대하고 있습니다 :)</p><h3>마치며</h3><p>이번 글에서 소개드린 세 가지 핵심 인프라와 문화, Trunk-based development, Feature Flag(Local + Amplitude), micro PR 은 저희 29CM iOS 팀에게 큰 변화를 가져다 주었습니다.</p><p>이를 통해 더 빠르게 개발하고, 더 빠르게 리뷰하고, 더 빠르게 머지하며, 결과적으로 더 빠르게 고객에게 가치를 전달하면서도 동시에 일정 수준 이상의 앱 안정성도 같이 유지하는 것을 목표로 할 수 있게 되었습니다.</p><p>오늘 소개드린 내용이 팀 차원의 개발 문화와 인프라에 관심이 많으신 개발자 분들께 도움이 되셨길 바라면서 이번 글을 마치겠습니다!</p><p>.</p><h3>함께 성장할 동료를 찾습니다</h3><p>29CM (무신사) 는 3년 연속 거래액 2배의 성장을 이루었습니다.</p><p>더 나은 방향을 가기위해 노력하는, 위에서 소개드린 내용에 관심이 많고 좋은 조직문화를 함께 가꾸어나가길 원하는 동료 개발자분들을 찾습니다.</p><p>특히 저희 iOS 팀은 비즈니스/플랫폼 영역에서 홈 개편, 컨텐츠 개인화, 새로운 포맷의 컨텐츠 개발, QA 자동화 프로세스, 자동화 테스트 구축, 지속적인 모듈화를 통한 microFeature Architecture 구축, 감도 높은 사용성을 위한 웹뷰 고도화, 디버깅 인프라 개선 등 여러 도전 과제들과 함께 진행할 iOS 엔지니어를 모시고 있습니다.</p><p>저희 팀에 대해 궁금한 점이 있으시면 iosdev@29cm.com 으로 메일을 남겨주세요. 가벼운 티타임도 가능합니다!</p><p>저희 iOS 포지션을 비롯해 많은 지원 부탁드립니다 :)</p><p><strong>🚀 29CM 채용 페이지</strong> : <a href="https://www.29cmcareers.co.kr/">https://www.29cmcareers.co.kr</a></p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=b703d646d945" width="1" height="1" alt=""><hr><p><a href="https://medium.com/29cm/trunk-based-development-feature-flag-micro-pr-%EC%99%80-%ED%95%A8%EA%BB%98-%EC%A3%BC-2%ED%9A%8C-%EB%B0%B0%ED%8F%AC%ED%95%98%EA%B8%B0-b703d646d945">Trunk-based development, Feature Flag, micro PR 와 함께 주 2회 배포하기</a> was originally published in <a href="https://medium.com/29cm">29CM TEAM</a> on Medium, where people are continuing the conversation by highlighting and responding to this story.</p>]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[iOS Modular Architecture 를 향한 여정 Part 2 — 프로젝트 모듈화, 레거시와 공존하기]]></title>
            <link>https://medium.com/29cm/ios-modular-architecture-%EB%A5%BC-%ED%96%A5%ED%95%9C-%EC%97%AC%EC%A0%95-part-2-%ED%94%84%EB%A1%9C%EC%A0%9D%ED%8A%B8-%EB%AA%A8%EB%93%88%ED%99%94-%EB%A0%88%EA%B1%B0%EC%8B%9C%EC%99%80-%EA%B3%B5%EC%A1%B4%ED%95%98%EA%B8%B0-d63f5e454573?source=rss-6761161ec96f------2</link>
            <guid isPermaLink="false">https://medium.com/p/d63f5e454573</guid>
            <category><![CDATA[architecture]]></category>
            <category><![CDATA[modular-architecture]]></category>
            <category><![CDATA[ios]]></category>
            <category><![CDATA[swift]]></category>
            <category><![CDATA[mobile]]></category>
            <dc:creator><![CDATA[Wooseong Kim]]></dc:creator>
            <pubDate>Fri, 21 Apr 2023 02:00:19 GMT</pubDate>
            <atom:updated>2023-10-11T06:42:07.368Z</atom:updated>
            <content:encoded><![CDATA[<h3>iOS Modular Architecture 를 향한 여정 Part 2 — 프로젝트 모듈화, 레거시와 공존하기</h3><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*HUvILVu436jhbGnv64K0hA.jpeg" /><figcaption><a href="https://www.freepik.com/free-vector/house-construction-set_26763763.htm">https://www.freepik.com/free-vector/house-construction-set_26763763.htm</a></figcaption></figure><p>안녕하세요, 29CM iOS 개발자 김우성입니다.</p><p>오랜만에 글을 쓰게 되었는데요, 지난 Part 1 글에 이어서 이번 글에서는 <strong>‘프로젝트 모듈화, 레거시와 공존하기’</strong>를 주제로 글을 써보려고 합니다.</p><p>모바일 앱 모듈화를 시작하면 보통 거대한 앱 타겟에서부터 모듈화를 시작하게 되기에 초기에는 모듈화 속도를 내기 위해 Bottom-up 으로 분리를 해나가는데요, 이 때 과거의 레거시가 자주 병목이 되곤 합니다.</p><p>레거시 코드는 과거에 회사의 비즈니스를 지속하게 해 주었던 좋은 친구들이지만 모듈화 관점에서는 작업 난이도를 높히는 요인 중 하나인데요, 이번 글을 통해 저희가 어떻게 레거시와 공존해나갔는지 실제 사례와 함께 하나씩 소개드리겠습니다.</p><h3>1. Protocol 을 활용한 레거시 격리</h3><p>저희 팀에서는 작업 초기 최하단 Shared 레어어를 분리하고 이어서 API 로직들을 분리하고 있었습니다. 이를 모듈로 분리하는 과정에서 API 캐시 사용 여부를 받아올 수 있는 오래된 유틸 클래스(무려 이름도 Common.. )가 가장 먼저 문제가 되었습니다.</p><p>Common 이라는 거대한 유틸 클래스는 태초(?)부터 존재했던 클래스로, 여러 이유로 분리가 정말 쉽지 않았습니다 😂</p><pre>// Common.swift<br>// App<br>class Common {<br>  ...<br>  // 태초부터 존재(?)했던 코드로 히스토리 파악이 쉽지 않습니다.<br>  private var _useCacheApi: Bool = true<br>  var useCacheAPI: BOOL { return _useCacheApi }<br>  ...<br>}</pre><pre>// BannerAPI.swift<br>// App<br>enum BannerAPI: DefaultTargetType {<br>  ...<br>  var useCache: Bool {<br>    return Common.shared.useCacheApi<br>  }<br>}</pre><p>네트워킹 로직을 분리해야 이를 의존하는 다음 로직들을 분리할 수 있었기에 Common 을 먼저 분리하고 네트워킹을 분리하는 식으로 진행을 하거나(정석이지만 시간 소요가 큼), 아니면 다른 효율적인 방법을 찾아볼 필요가 있었죠.</p><p>그래서 Protocol 기반의 추상화를 통해 이 문제를 해결해 보기로 했습니다. Networking 레이어로 옮길 파일 입장에서 필요한 정보들을 Protocol 로 먼저 정의하고(가능하면 잘게 나누는게 좋습니다), 우선 이를 기반으로 모듈 내에서 컴파일이 되도록 코드를 수정합니다.</p><pre>// NetworkingAPICacheProtocol.swift<br>// AppCore_Networking<br><br>// 앱 타겟에서 못 옮기고 있는 Common.shared.useCacheApi 를 추상화합니다.<br>// 마이그레이션 후 앱 타겟에서 코드를 제거하고 이 프로토콜도 제거하면 됩니다.<br>public protocol NetworkingAPICacheProtocol {<br>  var useCacheApi: Bool { get }<br>}<br><br><br>// Common.swift<br>// App<br>class Common {<br>  ...<br>}<br>// 향후 쉬운 분리를 위해 extension으로 처리합니다.<br>extension Common: NetworkingAPICacheProtocol {<br> var useCacheApi: Bool { return _useCacheApi } // 구현부는 우선 그대로 두고 인터페이싱에만 집중합니다.<br>}<br><br><br>// BannerAPI.swift<br>// AppCore_Networking<br>enum BannerAPI: DefaultTargetType {<br>  ...<br> var useCache: Bool {<br>  let networkingApiCache = DI.synchronize().resolve(NetworkingAPICacheProtocol.self)<br>    return networkingApiCache?.useCacheApi ?? true<br> }<br>}</pre><p>그리고 모듈이 이 의존성을 resolve 만 할 수 있으면 모듈로 기능할 수 있게 되는데요,저희는 많이 사용되는 DI Container 인 Swinject 로 해결했습니다.</p><p>그러면 DI Container 에 의존성 등록을 해 주어야 하는데, Common 은 앱 타겟에 있으니 앱 타겟에 만들어 두었던 NetworkingAssembly 에서 의존성 주입 처리를 해 주면 됩니다.</p><pre>// NetworkingAssembly.swift<br>// App<br>final class NetworkingAssembly: Assembly {<br>  ...<br>  private func registerNetworkingAPICache(container: Container) {<br>    container.register(NetworkingAPICacheProtocol.self) { _ in Common.shared }<br>  }<br>}</pre><p>이상적인 방향이라 볼 수는 없으나 이렇게 workaround 를 하면 레거시 로직으로 인한 커플링 이슈를 완화하면서 모듈 분리에 먼저 집중할 수 있게 됩니다. 먼저 분리하고, 리팩토링은 나중에 하는 등의(혹은 상황에 따라 그냥 안하거나) 선택을 할 수 있어 장기전인 모듈화를 조금 더 수월하게 할 수 있게 됩니다.</p><p>다른 예시를 보겠습니다. 저희 팀에는 오래전부터 ‘로그인한 유저 정보’를 의미하는 UserModel 이라고 하는 모델 클래스가 있었는데요, 문제는 이 클래스가 로그인과 관련된 수많은 로직을 가지고 있었습니다. (지양해야 하는 방향이겠지만 레거시 코드인지라 가슴으로 받아들입니다 😅)</p><p>UserModel 을 Entity 모듈로 분리를 해야 이 모델을 의존하는 다른 클래스들을 앱 타겟에서 분리할 수 있었는데요, 로그인 관련 비즈니스 로직은 여러 의존성들이 복잡하게 엮어 당장 앱 타겟에서 분리하기가 쉽지 않았던 상황이었어요.</p><pre>// UserModel.swift<br>// App<br>class UserModel {<br>  var userID: String?<br>  var userName: String?<br>  ... <br><br>  func clearUserInfo() { ... }<br>  func resetUserInfo() { ... }<br>  func updateUserInfo(...) { ... }<br>  ...<br>}</pre><p>그래서 앞 예시와는 조금 다른 결로, <strong>당장 분리하기가 어려운 비즈니스 로직만을 앱 타겟에 남겨 두고 옮길 수 있는 로직만 옮기는 방향</strong>으로 처리를 했습니다. 그리고 로그인 유저 라는 맥락에 맞게 리네이밍도 같이 진행했어요.</p><pre>// CurrentUserManagerProtocol.swift<br>// AppCore_Entity<br>public protocol CurrentUserManagerProtocol {<br>  func clearUserInfo()<br>  func resetUserInfo()<br>  func updateUserInfo(...)<br>}<br><br><br>// CurrentUser.swift<br>// AppCore_Entity<br>public class CurrentUser {<br>  var userID: String?<br>  var userName: String?<br>  ... <br>}<br><br><br>// CurrentUser+Extension.swift<br>// App<br>extension CurrentUser: CurrentUserManagerProtocol {<br>  func clearUserInfo() { ... }<br>  func resetUserInfo() { ... }<br>  func updateUserInfo(...) { ... }<br>}</pre><p>위 방식을 통해 다른 의존성 때문에 쉽게 분리할 수 없는 CurrentUser 의 비즈니스 로직들은 우선 앱 타겟에 그대로 격리하고 모델은 Entity 모듈로 옮길 수 있게 됩니다.</p><p>뿐만 아니라 향후에는 CurrentUserManagerProtocol 의 구현체로 CurrentUserManager 를 새로 구현하면서 모듈로 분리하게 되면 CurrentUser 모델에 직접 의존하지 않도록 개선하는 것도 가능해 집니다.</p><h3>2. ViewController 추상화를 통한 레거시 격리</h3><p>하위 레이어를 어느정도 분리한 뒤에 마주하는 대표적인 병목은 ViewController 입니다. 예컨대 앱 타겟에 레거시 A 화면과 레거시 B 화면이 있는데, 새로 만든 C 화면은 모듈로 분리하고 싶은데 C 화면에서 A 화면과 B 화면을 표시해야 하는 경우 처럼 화면간 의존이 생기는 경우가 빈번합니다.</p><p>이럴 때 유용한 방법으로, ViewController 를 추상화하고, 이를 생성하는 팩토리도 같이 추상화를 해서 팩토리를 의존성으로 주입하는 방법을 사용합니다.</p><p>특정 ViewController 의 인스턴스를 만들기 위해선 어떤 정보가 필요할까요? 이 ViewController 가 가져야 하는 의존성과, 그리고 인스턴스 생성에 필요한 Runtime parameters (저희는 Payload 라 명명한) 정보가 필요합니다.</p><p>그렇다면 이 추상화 된 팩토리가 <strong>Payload 를 파라미터로 받아서 ViewControllerType 을 반환하는 클로저를 내포하고 있다면</strong> 이 추상화 팩토리 의존성과 함께 뷰컨트롤러 인스턴스를 만드는 것이 가능해 집니다. 팩토리 입장에서는 클로져 내부가 어떻게 되어 있든(블랙박스) 외부에서 주입받아 사용할 수만 있으면 되는 것이구요.</p><p>이런 방식을 통해 새로 제작하는 C 화면에서 레거시 A 화면 / B 화면을 생성하도록 해 볼 것인데요, 아래 코드로 보시겠습니다.</p><pre>// ViewControllerType.swift<br>// AppCore_UI<br><br>// 추상화 된 ViewController<br>public protocol ViewControllerType where Self: UIViewController {}<br><br>/// 추상화 된 ViewController 를 생성하기 위한 추상 팩토리 타입<br>public protocol ViewControllerFactoryType {<br><br>  /// ViewController 를 생성하는 데 필요한 런타임 파라미터<br>  associatedtype Payload<br><br>  /// 런타임 파라미터를 받아 ViewController 를 생성하는 클로저<br>  typealias FactoryClosure = (Payload) -&gt; ViewControllerType<br>  var factoryClosure: FactoryClosure { get }<br><br>  /// ViewControllerType 생성 인터페이스<br>  func create(payload: Payload) -&gt; ViewControllerType<br>}</pre><p>위와 같이 추상화 뷰컨트롤러/뷰컨트롤러 팩토리를 먼저 UI 레이어에 선언을 해 둡니다. 그리고 레거시 A 화면 클래스가 ViewControllerType 를 준수하도록 만들어 주시면 추상화 팩토리를 통해 인스턴스를 생성할 수 있게 됩니다.</p><pre>// LegacyA_ViewControllerType.swift<br>// AppFeature_Domain (혹은 더 아래 레이어에 위치)<br>protocol LegacyA_ViewControllerType: ViewControllerType {}<br><br>struct LegacyA_ViewControllerFactoryType: ViewControllerFactoryType {<br>  struct Payload {<br>    let paramA: String<br>    let paramB: SomeClass<br>  }<br>  var factoryClosure: FactoryClosure<br>  init(_ factoryClosure: @escaping FactoryClosure) {<br>    self.factoryClosure = factoryClosure<br>  }<br>}<br><br><br>// LegacyA_ViewController.swift<br>// App<br>final class LegacyA_ViewController: UIViewController, LegacyA_ViewControllerType {<br>  struct Payload {<br>    let paramA: String<br>    let paramB: SomClass<br>  }<br><br> ...<br><br> init(payload: payload) {<br>    ...<br>  }<br>}</pre><p>물론 현실 세계에서는 파라미터 뿐만 아니라 유저 액션에 대한 옵저버라던지 더 많은 Payload 가 있어야겠지만 예시 코드인지라 최대한 단순화했습니다.</p><p>뷰컨트롤러 코드는 앱 타겟에 있기에, 하위의 C 피쳐 모듈에서 사용하려면 LegacyA_ViewControllerFactoryType 를 주입받아야만 하고, 그러기 위해 DI Container 에 의존성을 등록해 주어야 합니다.</p><pre>// LegacyA_Assembly.swift<br>// App<br>final class LegacyA_Assembly: Assembly {<br>  ...<br>  private func registerLegacyA(container: Container) {<br>    container.register(LegacyA_ViewControllerFactoryType.self) { _ in <br>      <br>      // 추상 뷰컨트롤러 팩토리 생성 시 `factoryClosure` 주입<br>      LegacyA_ViewControllerFactoryType { payload in<br>        return LegacyA_ViewController(payload: .init(<br>          paramA: payload.paramA,<br>          paramB: payload.paramB,<br>          ...<br>        )<br>      }<br>    }<br>  }<br>}</pre><p>이처럼 뷰컨트롤러가 위치하는 모듈에서 추상화 뷰컨트롤러 팩토리를 DI에 등록해 준 뒤, 새 모듈에서 개발하는 C 화면에서는 팩토리를 주입 받아서 사용하도록 구현해 주면 됩니다.</p><pre>// C_ViewController.swift<br>// FeatureC<br>final class C_ViewController: UIViewController {<br>  struct Dependency {<br>    let legacyA_ViewControllerFactory: LegacyA_ViewControllerFactoryType<br>  }<br>  ...<br><br>  func presentLegacyA_ViewController() {<br>    let legacyA_ViewController = self.dependency.legacyA_ViewControllerFactory.create(payload: .init(<br>      paramA: &quot;parameter&quot;,<br>      paramB: SomeClass(...),<br>    ))<br>    self.present(legacyA_ViewController, animated: true)<br>  }<br>}</pre><p>위 예시에서는 레거시에 대해서만 언급을 했지만, 새로 만드는 화면들에서도 동일하게 활용이 가능합니다.</p><p>피쳐 C 화면의 추상 클래스는 FeatureC_Interface 모듈에 선언이 되어 있고 마찬가지로 피쳐 D 화면의 추상 클래스는 FeatureD_Interface 모듈에 선언을 하게 되는데요, 새로 만들 피쳐 모듈의 구현체 모듈에서도 특정 피쳐의 인터페이스 타겟만 의존성으로 가지게 하면 마찬가지로 동일하게 사용할 수 있습니다.</p><pre>// Project.swift (Tuist)<br>// FeatureD<br>let implementTargets = Project.implementTargets(<br>  ...<br>  dependencies: [<br>    ...<br>    .workspace.app.feature.featureC.interface, // Dynamic Framework 로 되어 있는 피쳐 C 모듈의 인터페이스 타겟<br>  ]<br>)<br><br>let project = Project(<br>  ...<br>)<br><br><br>// D_ViewController.swift<br>// FeatureD<br>final class D_ViewController: UIViewController {<br>  struct Dependency {<br>    let c_viewControllerFactory: C_ViewControllerFactoryType<br>  }<br>  ...<br><br>  func presentC_ViewController() {<br>    let c_ViewController = self.dependency.c_viewControllerFactory.create(payload: .init(<br>      ...<br>    ))<br>    self.present(c_ViewController, animated: true)<br>  }<br>}</pre><h3>마치며</h3><p>이번 글에서는 프로젝트 모듈화를 해나가면서 마주치는 여러 레거시들과 어떻게 공존해나갔는지에 대해 두 가지 형태로 소개를 드리게 되었는데요, 저희 팀에서는 이런 workaround 들을 활용해 모듈화에서 마주치는 여러 병목들을 전부 해소하지 않고서도 모듈을 점진적으로 분리해나가는 방향을 주로 택하고 있습니다.</p><p>현재 저희는 <strong>Shared / ThirdParty / AppCore / AppFeature / App</strong> 다섯 개의 레이어로 아래와 같이 모듈화를 해나가고 있습니다. 현 Phase 의 아키텍쳐가 어느정도 안정화가 될 즈음에는 하나의 레이어를 더 추가하게 될지도 모르겠네요.</p><p>저희 팀은 비즈니스에 강하게 포커스가 된 팀인지라 아직도 많은 모듈화 여정이 남기는 했습니다만, 그럼에도 아래와 같이 하나씩 점진적 개선을 통해 팀의 비즈니스 속도를 늦추지 않도록 팀의 생산성을 계속해서 일정 이상 유지하는 것이 목표입니다.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*QeEXzRzi6etY-lW2Y-uHPg.png" /><figcaption>현재 저희 팀은 AS-IS 에서 TO-BE 로 가는 단계입니다.</figcaption></figure><p>이 여정에 대한 글을 쓰면서 3부작을 생각했었는데요, Tuist 도입은 이미 팀 동료이신 <a href="https://medium.com/29cm/tuist-%EB%A1%9C-%EA%B0%80%EB%8A%94-%EC%97%AC%EC%A0%95-part-1-xcodegen-%EC%97%90%EC%84%9C-tuist-%EB%A1%9C-%EC%A0%84%ED%99%98%ED%95%98%EA%B8%B0-886260144b37">형석님께서 쓰신 글</a>이 있는지라 Part 3에서는 Tuist 내용은 제외하고 아키텍쳐 레이어에 대한 글을 써볼까 합니다. 다만 아직 고민이 완전히 끝나진 않은 단계여서, 충분히 팀 내에서 고민이 완료된 이후 찾아뵙게 될 것 같네요 😃</p><p>이번 글이 팀에서 모듈화 병목을 해소하는데 도움이 되길 바라며, 향후 Part 3 글에서 또 찾아뵙겠습니다!</p><p><strong>[함께 성장할 동료를 찾습니다]<br></strong>29CM(무신사)는 3년 연속 거래액 2배의 성장을 이루었습니다.</p><p>앞으로도 더 큰 성장을 만들기 위해 여러 스쿼드에서 OKR을 기반으로 여러 피쳐들을 만들어 가고 있으며, 이번 글과 같이 팀 성장을 위한 인프라/플랫폼 업무를 하기도 합니다.</p><p>함께 성장하고 유저 가치를 만들어낼 동료 개발자분들을 찾고 있습니다.<br>많은 지원 부탁드려요!</p><p><strong>🚀 29CM 채용 페이지</strong> : <a href="https://www.29cmcareers.co.kr/">https://www.29cmcareers.co.kr/</a></p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=d63f5e454573" width="1" height="1" alt=""><hr><p><a href="https://medium.com/29cm/ios-modular-architecture-%EB%A5%BC-%ED%96%A5%ED%95%9C-%EC%97%AC%EC%A0%95-part-2-%ED%94%84%EB%A1%9C%EC%A0%9D%ED%8A%B8-%EB%AA%A8%EB%93%88%ED%99%94-%EB%A0%88%EA%B1%B0%EC%8B%9C%EC%99%80-%EA%B3%B5%EC%A1%B4%ED%95%98%EA%B8%B0-d63f5e454573">iOS Modular Architecture 를 향한 여정 Part 2 — 프로젝트 모듈화, 레거시와 공존하기</a> was originally published in <a href="https://medium.com/29cm">29CM TEAM</a> on Medium, where people are continuing the conversation by highlighting and responding to this story.</p>]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[Modular Architecture 를 향한 여정 (1) XcodeGen 도입과 모듈화 시작]]></title>
            <link>https://medium.com/29cm/modular-architecture-%EB%A5%BC-%ED%96%A5%ED%95%9C-%EC%97%AC%EC%A0%95-part-1-xcodegen-%EB%8F%84%EC%9E%85%EA%B3%BC-%EB%AA%A8%EB%93%88%ED%99%94%EC%9D%98-%EC%8B%9C%EC%9E%91-19a7f7b6401a?source=rss-6761161ec96f------2</link>
            <guid isPermaLink="false">https://medium.com/p/19a7f7b6401a</guid>
            <category><![CDATA[mobile]]></category>
            <category><![CDATA[modular-architecture]]></category>
            <category><![CDATA[ios]]></category>
            <category><![CDATA[architecture]]></category>
            <category><![CDATA[xcodegen]]></category>
            <dc:creator><![CDATA[Wooseong Kim]]></dc:creator>
            <pubDate>Thu, 21 Jul 2022 14:12:32 GMT</pubDate>
            <atom:updated>2023-04-18T06:52:43.161Z</atom:updated>
            <content:encoded><![CDATA[<h3>iOS Modular Architecture 를 향한 여정 Part 1 — XcodeGen 도입과 모듈화의 시작</h3><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*erqbV2R-OctauyROn1UAmA.png" /></figure><p>안녕하세요, 29CM iOS 개발자 김우성입니다.</p><p>저번 기술 블로그를 작성한 지 꽤 오랜 시간이 지났네요. 어떤 내용을 다뤄볼까 고민하다 이번 글에서는 여러 iOS 팀에서 고민하시는 Modular Architecture 를 29CM iOS 팀에서는 지금까지 어떻게 만들어 오고 있었는지, 그리고 앞으로는 어떻게 만들어 갈 것인지에 대해 이야기를 해볼까 합니다. (3부작 정도로 생각하고 있습니다 ㅎㅎ)</p><ul><li><strong>Part 1 : XcodeGen 도입과 모듈화의 시작 (본편)</strong></li><li>Part 2 : 프로젝트 모듈화, 레거시와 공존하기</li><li>Part 3 : 아키텍쳐 레이어의 변화와 Tuist 의 도입, 그리고 그 너머</li></ul><p>위와 같은 순서로 글을 작성할 예정이며, 현재 저희 팀은 Tuist 도입의 마무리 단계에 있습니다. 이는 아래에서도 잠깐 언급할 예정입니다.</p><p>.</p><p>작년 29CM 에 합류했을 당시 저희 iOS 프로젝트는 Xcode Project 나 Workspace 를 관리하는 도구(iOS 쪽에선 사실상 <a href="https://github.com/yonaskolb/XcodeGen">XcodeGen</a>/<a href="https://github.com/tuist/tuist">Tuist</a> 를 의미하겠죠) 를 사용하고 있지 않는 상태였습니다.</p><p>Squad-based 프로덕트 팀에서 여러 iOS 개발자가 효율적으로 협업하기 위해선 프로젝트 관리 도구가 다른 무엇보다 중요한 인프라라고 생각했기에, 합류 후 팀에서 가장 먼저 진행했던 것이 XcodeGen 도입입니다. 도입과 관련해선 좋은 글이 이미 워낙 많기에, 이번 글에서는 도입 자체를 다루진 않고 그 이후부터를 얘기하고자 합니다.</p><p>XcodeGen 이 도입된 시점에서 저희는 하나의 Project 와 하나의 Target(=앱) 만 가진 상태였습니다. 인프라나 플랫폼 작업이 보통 그렇듯 이것만 메인으로 진행하긴 현실적으로 어렵기에, 장기적인 시각으로 점진적으로 진행할 수 있도록 Milestone 을 가장 먼저 세웠습니다.</p><p>아래는 이 여정을 시작하기 전에 세웠던 것으로, 최초에는 3개의 Phase 만 정했습니다. 처음부터 시간을 들여 상세하게 Phase 를 나눌 수도 있었지만 입사 초기엔 프로젝트에 대한 이해도도 부족했을 뿐더러 우선 시작하는 것 자체가 더 중요하다 생각했었기에 첫 삽을 뜨고 난 이후에 Phase 를 더 상세하게 나누어도 된다는 생각이 있었습니다.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*XVuRgGS9GhBEgO8FQqqTZg.png" /></figure><p>Phase 1 을 진행하며 프로젝트의 현황이나 여러 레거시를 맞닿뜨리면서 좀 더 현실적인 방향으로 Phase 를 점점 더 세세하게 나누게 되었는데요, 아래의 스샷이 가장 최신화된 Phase 입니다. (현재 Phase 5 / Phase 6 가 같이 진행되고 있습니다)</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*LXIH07JyzgwwBLYS1hQ3MQ.png" /></figure><p>Tuist 를 도입하기로 하면서 앱 아키텍쳐 레이어를 현재는 다시 개편한 상태인데요, 그 전까진 아래와 같은 형태로 모듈을 분리해 오고 있었습니다.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*7UcGi04BkpRlMVJBTQv_9A.png" /></figure><p>어떤 과정을 거쳐 위와 같은 형태로 만들어나가게 되었는지 크게 세 가지의 꼭지로 말씀드리고자 합니다.</p><h3>1. 모듈화의 시작, Foundation 모듈과 아키텍쳐 틀 잡기</h3><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*_WBQfUx66gRU2y8AsuFX2w.png" /></figure><p>가장 쉽고 빠르게 할 수 있는 작업입니다. 각 모듈에서 거의 대부분 사용하게 되는 모듈이기도 해서 사실 가장 먼저 진행해야 하기도 합니다. 많은 코드들이 서로 의존하고 있었던 최초 상태에서도 Foundation 분리는 크게 어렵지 않았습니다.</p><ul><li>Foundation 프레임워크의 클래스들의 Extension 들</li><li>유틸성 로직</li><li>앞으로 만들 모듈들에서 공통으로 사용하게 될 오픈소스들(Swinject, Pure 등)</li></ul><p>정도가 있었습니다. 처음부터 모든 Foundation 성격의 파일을 앱 타겟에서 분리할 필요는 없습니다.</p><p>어느정도 분리가 되었다면 다음으로는 Modular Architecture 의 틀을 먼저 잡는 것이 좋습니다. 그래야 상호의존도가 강한 코드들을 조금씩 분리해 적절한 모듈에 넣으면서 조금씩 아키텍쳐를 발전시키기 용이하다는 생각입니다. 저희 팀은 아래와 같은 모듈들을 먼저 만들기 시작했습니다.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*wrjiFpRlj8AeqBO8_qMzbg.png" /></figure><p>Foundation 위 레이어를 보시면 Core / ThirdParty 레이어가 있는데요(실제 존재하는 모듈은 아니고 추상 레이어입니다), 사실 최초 작업 시에는 Core 레이어가 있지는 않았습니다.</p><p>첫 시작은 아래 정도의 모듈로만 시작했습니다.</p><ul><li>App29CM</li><li>App29CM_Domain</li><li>App29CM_SomeModule</li><li>App29CM_SomeModule2</li><li>…</li><li>ThirdParty_Firebase</li><li>…</li><li>App29CM_Foundation (Firebase 가 Foundation 모듈을 의존하게 되는데 네이밍이 이상하죠)</li></ul><p>빈 Entity, Networking, ReactiveX, Domain 등을 만들어 두고, 다른 개발을 하면서 조금씩 옮길 수 있을 때마다 적절한 모듈로 이동을 시켜 주었습니다. 그 과정에서 분리가 쉽지 않은 코드들이 많이 있었고 Part 2에서 소개할 방법들과 함께 상호의존을 먼저 제거하고 파일을 옮기는 식으로 주로 진행을 했었습니다.</p><p>다만 많이 진행하고 보니 모듈 네이밍 컨벤션이 좋지 않다고 느껴서, Tuist 도입을 하면서는 아키텍쳐 레이어를 새로 개편한 상태입니다. (Part 3 에서 소개 예정)</p><p>이번 단계에서 Firebase 모듈을 적었는데요, 경험적으로 다른 써드파티 SDK들 보다 Firebase 를 분리하는게 가장 어렵고 번거롭기 때문에 Modular Architecture 로 가는게 큰 병목 중 하나로 인지하고 모듈화 작업 초기부터 시간을 들였습니다.</p><p>기존엔 CocoaPods 로 Firebase SDK 를 가져오고 있었는데요, CocoaPods 로는 Firebase 부분을 모듈화 할 수 없습니다. (관련해서 오랜 기간에 걸쳐 여러 시도를 해봤었는데 불가능하다 판단했습니다. 혹시 가능한 방법을 아신다면 알려주시면 감사하겠습니다) 이는 XcodeGen 뿐만 아니라 Tuist 기반의 Workspace 에서도 마찬가지였습니다.(SPM 으로도 불가)</p><p>두 가지 방향이 가능한데요,</p><ul><li>필요한 Firebase SDK xcframework 를 레포에 포함시켜 로컬에서 Firebase 모듈에 링킹</li><li>Carthage 를 사용해 Firebase 모듈에 링킹</li></ul><p>이 중 팀이 선호하시는 방향을 선택하시면 될 것 같습니다.</p><p>SDK를 모듈에 링킹한 이후에는 모듈 내에서 다음과 같이 `@_exported import` 를 사용해 주고, 모듈 외부에서는 Firebase 모듈만 임포트를 해도 Firebase SDK 를 사용할 수 있도록 해 주시면 됩니다.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*hEYRMQn8tcrEpHu3VE2AVA.png" /></figure><p>다만 위 방식은 기존에 있던 여러 레거시 로직들로 인해 다른 모듈들에서 Firebase SDK 를 직접 알아야 할 때만 필요한 부분이고, 나머지 모듈에서 모든 Firebase SDK 의존이 제거된 이후에는 위 부분을 다시 제거하고 Firebase Interface / Implementation 모듈로 나누어 Interface 모듈로만 다른 모듈에 기능을 제공하도록 변경하시면 됩니다. (저희 팀에선 Tuist 도입 이후 본격적으로 진행하게 될 방향입니다)</p><h3>2. 아키텍쳐 틀에 맞게 모듈 분리해 나가기</h3><p>여기까지 진행이 되었으면 이제 모듈을 조금씩 더 만들고 파일들을 조금씩 더 옮겨가는 단계입니다. 보통은 Domain, Service 레이어의 로직이 가장 많은 상호 의존 이슈가 있을 것이라 예상할 수 있기에, 본격적인 모듈 분리에 앞서 Service 레이어 아래로의 로직들을 먼저 분리하는 단계라 보시면 됩니다.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*qYEM5oX3BUQWPP7tKofmYQ.png" /></figure><p>Feature Flag 같이 비교적 독립적인 코드들은 쉽게 분리할 수 있습니다. 그 외에 중요한 모듈은 Entity, Networking, ReactiveX 입니다. 각각의 모듈에서 모듈이 가져야 할 오픈소스들을 링킹하도록 하며(+ 동시에 앱 타겟에서는 제거), 향후 Service 모듈 작업을 위해 선행되어야 하는 필수 작업이기도 합니다.</p><p>그리고 이 시기에는, Foundation 모듈이 제대로 분리가 되었다면 ThirdParty 계열 모듈을 조금씩 분리할 수 있게 됩니다. 물론 써드파티와 관련된 로직들도 구현에 따라 분리가 쉽지 않은 경우가 있는데, 이 부분은 Part 2 에서 좀 더 다루려고 합니다.</p><p>Domain 모듈은 만들어 두었지만 이 시기에는 사실 크게 옮길 수 있는 파일들이 없습니다. 팀에 조금 더 시간적인 여유가 있는 상황이라면 Domain 보다 더 하위 모듈로 내려야 하는 파일이 여러 의존 때문에 못 내리는 상황에서 Domain 모듈로 우선 내려두는 결정을 할 수도 있습니다.</p><p>이러한 과정들을 통해 하나의 프로젝트와 타겟만 가지던 Workspace 가 (여전히 하나의 프로젝트이지만) 10개 이상의 모듈로 분리할 수 있게 됩니다. 여기서부터는 본격적으로 모듈을 분리할 수 있게 됩니다 :)</p><h3>마치며</h3><p>위에 언급했던 7 단계의 모듈화 작업에서, 현재 저희 팀은 Phase 5 / 6 을 진행하고 있습니다. Tuist 도입은 거의 마무리가 되었고 조만간 Tuist 로 만든 새 Workspace 에서 개발을 하게 될 것 같네요 :)</p><p>바뀐 Architecture Layer 만 이번 글에서 먼저 짧게 소개드리면 아래와 같습니다. 위에서 소개드린 수준까지 진행을 하고 보니 Tuist 를 제대로 적용하기 전에 조금 더 나은 형태로 레이어의 추가 개편이 필요하다는 생각이 드는 시기가 찾아왔습니다.</p><p>그래서 저희보다 더 큰 규모의 국내외 회사들의 사례를 찾아보게 되었는데요, 주로 아래와 같은 형태로 레이어 이름을 사용하는 것을 많이 보았습니다. 그래서 저희 조사에서 가장 많이 나왔던 형태로 각 레이어의 이름을 결정하게 되었습니다.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*2ywodF0qAphS6yFaIsoenQ.png" /></figure><ul><li>App</li><li>App Feature (Splash, Main, Product, Contents …)</li><li>App Core (Entity, Networking, Service, UI, Resource …)</li><li>ThirdParty (여러 SDK들)</li><li>Shared (App Core 와 ThirdParty 모듈이 의존하게 될 모듈들)</li></ul><p>위와 같은 형태로 만들어 갈 예정이고, Tuist 로 넘어간 이후에는 이 상태에서 추가로 Interface / Implementation 모듈로도 나누어 적절하게 dynamic/static 을 사용해 줄 예정입니다.</p><p>.</p><p>Modular Architecture 는 어떻게 보면 양도 너무 방대하고 방식도 다양해서, 하나의 글에서 상세한 내용을 다루기는 어려웠습니다. 그래서인지 이번 시리즈 작성을 오랫동안 미뤄왔던 것 같은데요, 이번 Part 1 글을 통해 iOS 팀 혹은 모바일 팀에서 모듈화를 시작하실 때 할 때 조금이나마 도움이 되실 수 있길 바라겠습니다.</p><p>그러면 조만간 ‘Modular Architecture 를 향한 여정 Part 2&#39; 글에서 또 뵙겠습니다!</p><h3>함께 성장할 동료를 찾습니다</h3><p>29CM 는 3년 연속 거래액 2배의 성장을 이루었습니다.</p><p>앞으로도 더 큰 성장을 만들기 위해 여러 스쿼드에서 OKR을 기반으로 여러 피쳐들을 만들어 가고 있으며, 이번 글과 같이 인프라 혹은 플랫폼 업무를 하기도 합니다.</p><p>함께 성장하고 유저 가치를 만들어낼 동료 개발자분들을 찾고 있습니다.<br>많은 지원 부탁드려요!</p><p><strong>🚀 29CM 채용 페이지</strong> : <a href="https://www.29cmcareers.co.kr/">https://www.29cmcareers.co.kr/</a></p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=19a7f7b6401a" width="1" height="1" alt=""><hr><p><a href="https://medium.com/29cm/modular-architecture-%EB%A5%BC-%ED%96%A5%ED%95%9C-%EC%97%AC%EC%A0%95-part-1-xcodegen-%EB%8F%84%EC%9E%85%EA%B3%BC-%EB%AA%A8%EB%93%88%ED%99%94%EC%9D%98-%EC%8B%9C%EC%9E%91-19a7f7b6401a">Modular Architecture 를 향한 여정 (1) XcodeGen 도입과 모듈화 시작</a> was originally published in <a href="https://medium.com/29cm">29CM TEAM</a> on Medium, where people are continuing the conversation by highlighting and responding to this story.</p>]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[Cocoapods-Binary-Cache 와 함께 버저닝된 Prebuilt Pod 캐시 운영하기]]></title>
            <link>https://medium.com/29cm/cocoapods-binary-cache-%EC%99%80-%ED%95%A8%EA%BB%98-%EB%B2%84%EC%A0%80%EB%8B%9D%EB%90%9C-prebuilt-pod-%EC%BA%90%EC%8B%9C-%EC%9A%B4%EC%98%81%ED%95%98%EA%B8%B0-16b11e977aa0?source=rss-6761161ec96f------2</link>
            <guid isPermaLink="false">https://medium.com/p/16b11e977aa0</guid>
            <category><![CDATA[xcode]]></category>
            <category><![CDATA[binary]]></category>
            <category><![CDATA[cocoapods]]></category>
            <category><![CDATA[ios]]></category>
            <category><![CDATA[mobile]]></category>
            <dc:creator><![CDATA[Wooseong Kim]]></dc:creator>
            <pubDate>Fri, 08 Oct 2021 05:13:01 GMT</pubDate>
            <atom:updated>2023-01-18T01:48:36.594Z</atom:updated>
            <content:encoded><![CDATA[<h3>Cocoapods Binary Cache 와 함께 버저닝된 Prebuilt Pod 캐시 운영하기</h3><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*Qr5zoosLAtg92FccOlKq1w.png" /></figure><p>안녕하세요, 29CM iOS 개발자 김우성입니다.</p><p>iOS 프로젝트에서 사용하는 오픈소스 라이브러리들을 주로 <a href="https://github.com/CocoaPods/CocoaPods">CocoaPods</a>, <a href="https://github.com/Carthage/Carthage">Carthage</a>, SPM 세 가지 도구로 관리하는데요, 이 중 가장 범용적으로 많이 사용되는 CocoaPods 를 Prebuilt framework 로 만들고 캐싱을 할 때 각 개발자 머신/빌드 머신 환경에 맞춰 잘 분리된 캐시를 효율적으로 관리하는 방법을 소개하려고 합니다.</p><p><a href="https://github.com/grab/cocoapods-binary-cache">Cocoapods-Binary-Cache</a> 에 대해선 레포 README 도 잘 되어 있고 이미 여러 글이 있어서 이번 글에서는 캐시 운영 부분에 조금 더 집중하려고 합니다.</p><h3>1. 왜 도입하게 되었는지?</h3><p>프로젝트 규모가 커져갈수록 빌드 속도는 느려져만 갑니다. 일정 규모를 넘어서면 팀의 생산성에 영향을 미칠 정도가 되는데요, 물론 좋은 성능의 맥을(M1이라던가..) 사용하는 방법이 가장 좋지만 분명 한계가 있습니다 😅</p><p>프로젝트 빌드 속도를 향상시키기 위해 주로 많이 택하는 두 가지 방식이</p><ol><li>Carthage 를 도입해 오픈소스 라이브러리를 Prebuilt framework 로 관리하기</li><li>프로젝트를 여러 개의 모듈로 분리하기</li></ol><p>인데요, 2번은 1번에 비해 효과를 보려면 기반 작업도 많이 필요하고 (모든 프로젝트는 레거시가 있기 마련이니까요..) 단기간에 유의미한 속도 개선을 이루기 어렵습니다. iOS 팀의 규모가 크다면 동시에 진행하는게 더 좋지만 작은 규모에서는 1번을 많이 택하곤 합니다.</p><p>그런데 Carthage 의 경우 관리를 안하기로 워낙 유명해서 Xcode 버전이 올라갈 때마다 불안함이 있고 가끔은 곤혹을 치루기도 해서(M1 초기에 쉽지 않았습니다..) CocoaPods 기반으로 Prebuilt framework 를 사용할 수 없나 고민하던 차 Grab 에서 만든 <a href="https://github.com/grab/cocoapods-binary-cache">Cocoapods-Binary-Cache</a> 를 찾게 되었습니다.</p><p>처음엔 이 라이브러리의 원조인 <a href="https://github.com/leavez/cocoapods-binary">Cocoapods-Binary</a> 를 사용했었는데 Prebuilt framework 를 순차적으로 만드는 점, 캐시 관리 등 아쉬운 점이 많아 Grab 의 라이브러리로 최종 정착하게 되었어요. 다만 이 라이브러리도 기능이 충분하지 않아 현재는 해당 레포를 fork 해서 개선 뒤 사용하고 있습니다.</p><p>최초 도입 시를 기준으로 클린 빌드가 약 40% 정도 빨라지는 효과를 보았으며, 증분 빌드 속도도 마찬가지로 유의미하게 향상되었습니다.</p><h3>2. 도입과 Remote Cache 활용</h3><p>레포의 <a href="https://github.com/grab/cocoapods-binary-cache/blob/master/README.md">README</a> 에 설명이 잘 되어 있고 도입 자체는 크게 어렵지 않습니다. 저희는 Bundler 를 쓰고 있어 Gemfile 에 `cocoapods-binary-cache` 의존성을 추가해 설치하고 Podfile 에서 적절한 설정을 해주었어요.</p><pre>config_cocoapods_binary_cache(<br>  excluded_pods: [<br>    ... # 혹시 모를 이슈를 대비해 메이저 SDK 라이브러리들을 주로 추가했습니다<br>  ],<br>  cache_repo: {<br>    &quot;default&quot; =&gt; {<br>      &quot;remote&quot; =&gt; &quot;<a href="https://#{ENV[&#39;IOS_BOT_USERNAME&#39;]}:#{ENV[&#39;COCOAPODS_BINARY_CACHE_TOKEN&#39;]}@github.com/29CM-Developers/ios-29cm-cocoapods-binary-cache.git">https://#{ENV[&#39;IOS_BOT_USERNAME&#39;]}:#{ENV[&#39;COCOAPODS_BINARY_CACHE_TOKEN&#39;]}@github.com/</a>#{ENV[&#39;IOS_POD_CACHE_REPO&#39;]}&quot;,<br>      &quot;local&quot; =&gt; &quot;./.cocoapods-binary-cache/prebuilt-frameworks&quot;<br>    }<br>  },<br>  prebuild_config: &quot;Debug&quot;,<br>  xcframework: true,<br>  device_build_enabled: true<br>)</pre><p>README 와 다른 부분만 조금 더 보강하자면 `remote` 부분인데요, 저희 팀은 GitHub Actions 러너를 돌리는 빌드 머신이 있어 위와 같은 방식을 택했고 빌드 머신과 개발자 머신에서 각각 사용할 수 있도록 민감한 정보들을 환경 변수로 분리하고 git 으로 트래킹하지 않도록 했어요. (빌드 머신은 GitHub Secrets 에서 주입, 개발자 머신은 환경 변수 파일)</p><p>`prebuild_config` 는 현재 버저닝된 캐시를 사용하고 있고 사내 빌드를 아카이브할 땐 릴리즈용 캐시를 사용하도록 해 두어서 개발자 머신에선 별도 지정없이 사용하도록 `Debug` 를 기본값으로 지정해 두었습니다. (릴리즈 Prebuilt framework 로 아카이브하지 않으면 Pod 의 dSYM 파일이 아카이브에 포함되지 않습니다)</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*jCFG8Pm812P8PdUIlL85WQ.png" /><figcaption><a href="https://github.com/grab/cocoapods-binary-cache/blob/master/docs/how_it_works.md">How it works</a> | 음.. 그렇다고 하네요..</figcaption></figure><h3>3. 운영상의 한계와 버저닝 캐시를 위한 개선</h3><p>위처럼 세팅하면 쉽고 빠르게 효과를 볼 수 있는데요, 제공되는 기능만 사용할 때 운영상의 한계가 존재합니다.</p><ul><li>Podfile 에 라이브러리 변화가 있을 때 개발자가 직접 prebuild + push 를 해 주어야 한다는 점 (휴먼 에러가 발생할 가능성이 항상 존재합니다)</li><li>Xcode 업데이트로 인해 Swift 버전이 일시적으로 여러 개 사용될 때 개발자 머신과 빌드 머신에서의 캐시 운영이 어려워지는 점</li><li>Debug/Release 캐시 운영에 추가 공수가 듦 (마찬가지로 휴먼 에러 가능성 존재)</li></ul><p>위와 같은 문제들을 겪으면서 운영에 지속적인 리소스가 들다 보니 자연스럽게 다음과 같은 생각을 하게 되었습니다.</p><blockquote>혹시 이걸 자동화할 순 없을까? 아니면 차라리 ‘pod install’ 처럼 활용할 수는 없을까?</blockquote><p>개선 작업의 초기에는 위와 같은 추상적인 생각만 가지고 접근을 했었는데 그러다보니 이번 글에서 소개드리는 내용을 구축하기 전까지 이런저런 시행착오가 많았습니다 ㅎㅎ;</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*6B2BL5kmTR_Pp9O8DpN4Ag.png" /><figcaption>시행착오의 흔적들.. 많이 갈아엎었네요 😅</figcaption></figure><p>개발자가 직접 개입하면 어떤 방식으로든 실수가 나올 수 있어서 결과적으로는 <strong>최대한 자동화 된 버저닝 캐시</strong>를 만드는 방향을 시도하게 되었습니다. 이를 이룰 수 있는 스펙을 다음과 같이 세워 두고 개선 작업을 시작했습니다.</p><ul><li>개발자가 Podfile 에 의존성을 추가하거나 삭제하고 스크립트를 실행하면 pod install 과 최대한 유사한 방식으로 Prebuild 한다. 이후 Podfile.lock 이 변하니 이 체크섬을 분기로 새로운 캐시를 Remote 에 바로 푸시해 준다.</li><li>개발자 머신/빌드 머신 등 환경이 달라지면 캐시도 분리해주고 이 경우에도 각 머신 환경에 맞는 캐시가 없다면 Prebuild 후 분기된 캐시를 새로 생성해서 Remote 에 푸시해 준다.</li><li>환경에 맞는 캐시가 있다면 프로젝트 구성 명령어에서 먼저 캐시를 fetch 해 Prebuild 없이 바로 프로젝트를 구성할 수 있어야 한다.</li></ul><p>이런 이슈를 개선할 <a href="https://github.com/grab/cocoapods-binary-cache/pull/86">PR</a> 을 레포에 작성하기도 했었는데요, 아쉽게도 최근엔 운영이 활발하지 않기도 하고 오랫동안 답이 없으셔서 결국 fork 를 뜬 저희 레포에서 개선해 사용하기로 했습니다. 아래 레포의 `support-diversified-cache` 브랜치에 위 스펙을 지원할 수 있는 변경사항들을 적용했어요.</p><p><a href="https://github.com/29CM-Developers/ios-cocoapods-binary-cache">https://github.com/29CM-Developers/ios-cocoapods-binary-cache</a></p><p>그래서 Gemfile 에선 다음과 같이 변경하게 되었습니다.</p><pre># Gemfile<br>...</pre><pre>gem &quot;cocoapods-binary-cache&quot;, <br>  git: &#39;<a href="https://github.com/29CM-Developers/ios-cocoapods-binary-cache.git&#39;">https://github.com/29CM-Developers/ios-cocoapods-binary-cache.git&#39;</a>,<br>  branch: &#39;support-diversified-cache&#39;</pre><pre>...</pre><h3>4. 버저닝 캐시 활용</h3><p>개선 이후엔 다음과 같이 사용하고 있습니다. 위에서 언급한대로 `pod install` 처럼 사용하기 위해 Makefile 에 `pod_binary_fetch` 과 `pod_install` 이라는 명령어를 만들었어요. 저희는 Xcodegen 을 쓰고 있어 결과적으로 Makefile 내 프로젝트 구성 명령어에서</p><ul><li>xcodegen generate</li><li>Pod 캐시 fetch (Swift Ver.+Podfile.lock 체크섬+Debug/Release 조합 키)</li><li>Pod prebuild (+ 캐시가 없었다면 Prebuild 후 캐시 푸시)</li></ul><p>순서로 수행하면서 프로젝트를 구성하게 됩니다. 혹시 Carthage + Rome 을 같이 사용 중이시라면 xcodegen generate 다음에 먼저 수행하도록 하시면 되구요.</p><p>그리고 평소에는 Pod 변경이 없으니 일상적인 개발에서 사용할 목적으로 `xcodegen + pod install` 만 하는 명령어도 만들어 두었습니다.</p><pre># Makefile</pre><pre>...</pre><pre>project:<br> make xcodegen_generate<br> make pod_binary_fetch<br> make pod_install</pre><pre>project_release:<br> make xcodegen_generate<br> make pod_binary_fetch_release<br> make pod_install_release</pre><pre># 일상적인 개발에 project 대신 사용하는 명령어입니다.<br>project_fast:<br> make xcodegen_generate<br> bundle exec pod install</pre><pre>pod_install:<br> bundle exec pod binary prebuild --no-fetch || bundle exec pod binary prebuild --repo-update --no-fetch<br> bundle exec pod binary push &quot;swift$$(make swift_version)-xcframework-$$(make podfile_lock_checksum)&quot;</pre><pre># 앱을 배포할 때 아카이브에 Pod 의 dSYM 들을 포함하기 위해 사용합니다.<br>pod_install_release:<br> bundle exec pod binary prebuild --config=Release --no-fetch || bundle exec pod binary prebuild --repo-update --config=Release --no-fetch<br> bundle exec pod binary push &quot;swift$$(make swift_version)-xcframework-release-$$(make podfile_lock_checksum)&quot;</pre><pre># Pod 캐시를 fetch 만 하고 싶을 경우 사용합니다.<br>pod_binary_fetch:<br> bundle exec pod binary fetch &quot;swift$$(make swift_version)-xcframework-$$(make podfile_lock_checksum)&quot;</pre><pre>pod_binary_fetch_release:<br> bundle exec pod binary fetch &quot;swift$$(make swift_version)-xcframework-release-$$(make podfile_lock_checksum)&quot;</pre><pre>...</pre><p>이번 글에는 내용이 없지만 릴리즈용으로 만들어 둔 명령어들은 GitHub Action workflow 에서 앱 아카이브 시 사용됩니다.</p><p>그 결과 팀에서 Swift 버전이 다른 N개의 Xcode 가 사용되고 있거나 빌드 머신에서 배포를 위해 Release 캐시가 필요하더라도 각각의 환경에 맞는 캐시가 전부 만들어지며 캐시 생성 또한 개발자나 빌드 머신이 특별하게 신경쓸 필요가 없게 되었습니다.</p><p>여러 개의 빌드 머신이 있다면 보통은 한 번에 macOS 나 Xcode 업데이트를 진행하기에 버전이 통일되어 있을 가능성이 높아 한 곳에서만 새로 캐시가 만들어진다면 다른 빌드 머신들은 이를 사용할 수 있게 됩니다. 또한 별도의 글로 소개드리겠지만 빌드 머신에서 Xcode 업데이트를 진행할 때에도 캐시가 분리되어 있기 때문에 다른 빌드 머신에는 영향을 끼치지 않도록 하는 효과도 생기게 됩니다.</p><h3>5. 마치며</h3><p><a href="https://github.com/grab/cocoapods-binary-cache">Cocoapods-Binary-Cache</a> 를 활용하면 빌드 속도를 많이 향상시킬 수 있으나 운영상 불편한 점이 여럿 있었는데요, 버저닝 캐시를 도입한 뒤부터는</p><ul><li>Debug/Release</li><li>Swift Ver.</li><li>Podfile.lock 체크섬</li><li>Etc. (like macOS Ver, architecture)</li></ul><p>등 여러 환경마다 각각 캐시를 만들고 캐시가 없다면 만들어서 푸시까지 해 주어 편하게 운영이 가능해졌습니다. 그리고 추후 필요하면 캐시 버저닝을 더 디테일하게 확장할 수도 있구요. (갑자기 이슈가 생겼을 때 캐시를 분리하기 위해 v1, v2 와 같은 postfix 를 사용할 수 있겠죠)</p><p>이번 글을 통해 Cocoapods-Binary-Cache 를 도입하시는데 도움이 되셨으면 좋겠네요!</p><p>읽어주셔서 감사합니다 🙏</p><p>PS)앞으로도 글을 몇개 더 쓰려고 하는데요, 다음과 같은 주제들이 예정되어 있습니다. 혹시라도 먼저 보고 싶으신 내용이 있으시다면 순서를 조정해 보겠습니다 :)</p><ul><li>Microsoft App Center 와 함께 쉽고 빠르게 사내 빌드 전달하기</li><li>Feature Flag 기반으로 개발 중인 피쳐를 Dev / Canary / RC / Stable 빌드 중 원하는 곳에만 노출하기</li><li>Feature Flag + GitHub Actions 로 매주 안정적으로 배포하기</li><li>GitHub Actions Runner label 을 활용해 빌드 머신에서 Xcode 업데이트하기</li></ul><h3>함께 성장할 동료를 찾습니다</h3><p>29CM (에이플러스비) 는 3년 연속 거래액 2배의 성장을 이루었습니다.</p><p>함께 성장하고 유저 가치를 만들어낼 동료 개발자분들을 모십니다.<br>많이 지원해 주시면 감사하겠습니다 :)</p><p><strong>🚀 29CM 채용 페이지</strong> : <a href="https://www.29cmcareers.co.kr/">https://www.29cmcareers.co.kr/</a></p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=16b11e977aa0" width="1" height="1" alt=""><hr><p><a href="https://medium.com/29cm/cocoapods-binary-cache-%EC%99%80-%ED%95%A8%EA%BB%98-%EB%B2%84%EC%A0%80%EB%8B%9D%EB%90%9C-prebuilt-pod-%EC%BA%90%EC%8B%9C-%EC%9A%B4%EC%98%81%ED%95%98%EA%B8%B0-16b11e977aa0">Cocoapods-Binary-Cache 와 함께 버저닝된 Prebuilt Pod 캐시 운영하기</a> was originally published in <a href="https://medium.com/29cm">29CM TEAM</a> on Medium, where people are continuing the conversation by highlighting and responding to this story.</p>]]></content:encoded>
        </item>
    </channel>
</rss>