[iOS] - Texture 설치하기

🥕 Texture 설치하기(Install Texture)

📝 개요

• Texture를 설치하는 과정을 살펴보도록 하겠습니다! Texture가 무엇인지에 대한 자세한 이야기는 다른 글에서 추후 설명하도록 하겠습니다.

  
  

  Texture 공식 github

  
  

  우선 이번 글은 어떻게 설치하는지 그 과정을 따라가보도록 하겠습니다 :)

  
  

🛠 CocoaPods 설치하기

• Texture 공식 github을 살펴보면 installation에서 설치를 위해 두가지 방법이 있습니다.

  
  

  1. CocoaPods
  2. Carthage

  
  

  저는 CocoaPods를 이용해 설치를 진행해보겠습니다. 우선 CocoaPods의 설치가 필요합니다.

  
  

  $ sudo gem install cocoapods

  
  

  정상적으로 설치되시는 분들도 있겠지만, 저의 경우(BigSur 11.4, M1 Mac) 아래와 같은 에러가 발생했습니다.

  
  

  ERROR: While executing gem ... (Gem::FilePermissionError)
  You don't have write permissions for the /usr/bin directory.

  
  

  검색해보니 Mac의 시스템 Ruby를 사용하기 때문에 문제가 발생했고, 해결법의 자세한 설명은 아래 블로그에 나와있습니다.

  해결법

  
  

  간략하게 정리하면 필요한 명령은 다음과 같습니다.

  
  

  $ brew update
  
  $ brew install rbenv ruby-build
  
  $ rbenv install -l // Ruby 버전이 나오고 이 글의 경우 2.7.4 버전으로 진행
  
  $ rbenv global 2.7.4
  
  $ rbenv versions // *를 통해 현재 버전 체크 가능
  
  $ echo '# rbenv' >> ~/.bash_profile
  
  $ echo 'export PATH=~/.rbenv/bin:$PATH' >> ~/.bash_profile
  
  $ echo 'eval "$(rbenv init -)"' >> ~/.bash_profile
  
  $ source ~/.bash_profile
  
  $ gem install bundler
  

  
  

  위의 작업을 거친 후 다시 CocoaPods를 설치하면 정상 설치가 됩니다.

  
  

  $ sudo gem install cocoapods

  
  

🧑🏻‍💻 Texture 설치하기

• 이제 CocoaPods를 설치하고 싶은 프로젝트의 디렉토리로 이동하여 작업을 진행합니다.

  
  

  $ pod init

  
  

  🧐 프로젝트가 없는 위치에서 pod init을 하면 아래와 같은 메세지가 뜹니다.

  
  

  [!] No Xcode project found, please specify one

  
  

  프로젝트가 존재하는 위치에서 정상적으로 pod init을 할 경우 해당 위치에 아래 파일이 생성됩니다.

  
  

  PodFile

  
  

  이제 위의 PodFile에서 Texture를 추가해주는 작업을 합니다. 우선 위의 PodFile을 열기 위해 저는 nano를 사용했습니다.

  
  

  $ nano Podfile

  
  

  그럼 아래와 같은 문서가 열리게 됩니다.

  
  

  # Uncomment the next line to define a global platform for your project
  # platform :ios, '9.0'
  
  target '프로젝트 명' do
    # Comment the next line if you don't want to use dynamic frameworks use_frameworks!
  pod 'Texture' # 여기에 추가!!
    # Pods for 프로젝트 명

  
  

  위에 작성한 것처럼 target do 아래에

  
  

  pod 'Texture'

  
  

  를 추가합니다.

  작성이 끝났으면 저장하고 종료를 해야합니다. 저는 (^ + x)로 종료했습니다 :)

  
  

  이제 마무리 작업만 필요합니다. 아래의 명령어를 입력해줍니다.

  
  

  $ pod install
  
  $ pod update Texture

  
  

  이제 Texture의 설치는 무사히 완료되었습니다. 이제 Texture를 사용하기 위해 프로젝트에서 기본적인 작업을 해주면 됩니다!

  
  

⚙️ Texture 사용을 위한 기본 작업

• 이제 다시 Xcode를 켜고 프로젝트에 들어갑니다. 프로젝트에서 우선 자동으로 생성된 storyboard 파일을 제거해줍니다. 저는 Main.storyboard와 LaunchScreen.storyboard를 제거해주었습니다.

  
  

  그리고 Info.plist에 들어가서 Main으로 검색해줍니다.

  
  

  

  
  

  위에 밑줄 쳐진 Storyboard Name과 Main storyboard file base name을 제거해줍니다.

  
  

  스토리보드가 있을 때에는 앱이 실행되면 처음으로 보여줄 ViewController가 지정이 되었는데, 지금은 삭제되었기 때문에 SceneDelegate에서 설정을 해줘야합니다.

  
  

  class SceneDelegate: UIResponder, UIWindowSceneDelegate {
  
      var window: UIWindow?
  
      func scene(_ scene: UIScene, willConnectTo session: UISceneSession, options connectionOptions: UIScene.ConnectionOptions) {
          // Use this method to optionally configure and attach the UIWindow `window` to the provided UIWindowScene `scene`.
          // If using a storyboard, the `window` property will automatically be initialized and attached to the scene.
          // This delegate does not imply the connecting scene or session are new (see `application:configurationForConnectingSceneSession` instead).
          guard let windowScence = (scene as? UIWindowScene) else { return }
  
                  window = UIWindow(windowScene: windowScence)
                  window?.windowScene = windowScence
  
                  let rootViewController = HomeViewController()
                  window?.rootViewController = rootViewController
                  window?.makeKeyAndVisible()
      }
    ....

  
  

  위와 같이 rootViewController 인스턴스를 생성해줍니다.

  
  

  🧐 위의 작업을 문제없이 완료했는데 import가 되지 않네요?

  • 우선 Texture를 사용하기위해 아래와 같이 import 해야합니다.

    
    

    import AsyncDisplayKit

    
    

    그런데 자동완성이 안됩니다! 그 이유는 공식 문서의 설치 메뉴얼 마지막에 있습니다.

    
    

    Don’t forget to use the workspace .xcworkspace file, not the project .xcodeproj file.

    
    

    즉, 프로젝트.xcodeproj 파일을 통해 프로젝트를 열면 import가 되지 않습니다. 다시 프로젝트.xcworkspace 파일을 통해 프로젝트를 열면 정상적으로 import 되는 것을 확인할 수 있습니다.

    
    

  이제 본격적으로 Texture에 대해 학습하고, 글을 남겨보도록 하겠습니다! 🥕