iOS용 Facebook SDK 업그레이드 가이드

최신 버전의 변경 사항 검토

새로운 버전의 Facebook SDK로 업그레이드하기 전에 GitHub에서 변경 사항을 검토해야 합니다. 이를 통해 결과로 코드의 어떤 부분을 변경해야 하는지 파악할 수 있습니다.

참고: 9.0.0 버전 이상으로 업그레이드하는 경우 autoInitEnabled 옵션이 SDK에서 삭제됩니다. initializeSDK 메서드를 사용하여 SDK를 명시적으로 초기화하거나 applicationDidFinishLaunching에서 해당 메서드를 호출하여 SDK를 암시적으로 초기화해야 합니다. 자세한 내용은 변경 사항의 9.0.0 섹션을 참조하세요.

Swift 패키지 관리자(SPM)를 사용한 업그레이드

앱이 SPM을 사용하여 iOS용 Facebook SDK를 통합할 경우 다음 단계를 따르세요.

위 링크의 빠른 시작에서는 버전 옵션에 다음 주 버전까지를 선택하도록 지시합니다. 즉, 사용자가 지정한 주 버전 이후로는 자동 업데이트되지 않습니다(8.x.x을 선택하면 주 버전 9.x.x로 업그레이드되지 않음). 이는 현재 사용하는 패키지와 호환되지 않는 버전으로 업데이트하지 않도록 합니다.

증분적 업데이트

버전 업데이트가 증분 방식일 경우(부 버전 또는 패치 버전이 증분 방식)

Xcode에서 파일 > Swift 패키지 > 최신 패키지 버전으로 업데이트를 클릭합니다.

다음 이미지에 예시가 있습니다.

주 버전 업데이트

주 버전을 업그레이드하기 전에 변경 사항을 확인하세요. 버전 업데이트가 주 버전 변경이라면 패키지 설정을 변경해야 할 수도 있습니다.

1. 프로젝트 설정에서 Swift 패키지 탭을 클릭합니다. 다음 이미지에 예시가 있습니다.


2. Facebook 패키지를 선택해 설정을 표시합니다. 버전을 업그레이드할 주 버전(이 예시 이미지에서는 9.0.0)으로 변경하고 완료를 클릭합니다.


3. 패키지를 업그레이드합니다. Xcode에서 파일 > Swift 패키지 > 최신 패키지 버전으로 업데이트를 클릭합니다. 다음 이미지에 예시가 있습니다.
   

프로젝트 설정에서 주 버전 대상을 변경하고 최신 패키지 버전으로 업데이트를 다시 실행하면 대상 버전을 롤백할 수 있습니다.

CocoaPods를 사용한 업그레이드

앱이 Cocoapods를 사용하여 iOS용 Facebook SDK와 통합할 경우 다음 단계를 따르세요.

1. pod의 기한이 만료되었는지 확인하세요. 다음 명령을 실행하면 기한이 만료된 pod가 나옵니다.

   pod outdated
   

2. 다음 명령으로 기한이 지난 pod를 업데이트하세요.

   pod update  [PODNAME]
   

CocoaPods는 [PODNAME]에서 지정한 pod의 업데이트 버전을 찾으려고 시도하고 Podfile의 버전 제한 사항에 따라 가장 최신 버전으로 업데이트합니다. 제한 사항이 있으면 경우 이를 수정해야 주 버전 간 업그레이드가 가능할 수 있습니다.

다시 컴파일하고 문제 해결

대상 SDK 업그레이드를 완료했다면 다시 컴파일하고 이후에 발생하는 문제를 해결하세요. 일반적으로 새로운 주 버전으로 업그레이드할 때만 문제가 나타납니다.

GitHub의 변경 사항을 참조하여 어떤 컴파일 문제가 발생할 수 있는지 확인하세요.

새로운 그래프 API 버전으로 업그레이드

새로운 버전의 그래프 API로 업그레이드하고 싶다면 업그레이드 도구를 사용하여 앱에 필요한 변경 사항을 평가할 수 있습니다. 그래프 API 변경 사항을 참조하실 수도 있습니다.