[iOS] 애플 개발자 문서 읽는 법

오늘은 애플 개발자 문서를 활용하는 방법에 대해 정리해보려 합니다. 

 

◎ 애플 개발자 문서를 읽어야 하는 이유

1. 애플에서 제공하는 문서인 만큼 그 내용이 정확합니다.

2. 새롭게 등장하는 기술에 대한 설명이 가장 먼저 반영됩니다. 

3. 프레임워크와 클래스의 구동 방식을 이해하고 적절한 메서드/프로퍼티를 찾아 애플리케이션에 올바르게 적용할 수 있습니다. 

4. 오류가 발생했을 때 적절한 해결방안을 찾을 수 있습니다. 

5. 구글링 해서 쉽게 얻은 코드를 그대로 사용하거나 조금만 수정해서 사용하면 머리에 남는 것이 많이 없는 느낌입니다. 결국 온전히 자신의 힘으로 무언가를 만들거나 응용하기 어려워지는 거죠! (제 개인적인 생각) 

 

◎ 애플 개발자 문서 구성

 

◎ 애플 개발자 문서 읽는 법

애플 개발자 문서: developer.apple.com/documentation/

우선 개발을 시작하기 전에, 하단의 가이드들을 읽고 시작하면 좋다고 합니다!

(하지만 지금은 다 Documentation Archive에 들어가 있는 더 이상 업데이트 되지 않는 내용들 입니다. 그래도 essential 한 내용들은 시간이 지나도 변하지 않을테니, 꼭 읽어보시길 추천드립니다.)

• Memory Management Programming Guide
• iOS Application Programming Guide
• iOS Development Guide
• Cocoa Fundamentals Guide
• Resource Programming Guide
• View Programming Guide for iOS
• View Controller Programming Guide for iOS
• Event-Handling Guide for iOS
• Key-Value Coding Programming Guide
• Key-Value Observing Programming Guide
• Xcode Project Management Guide

 

- 문서 읽기 순서

1. 사용하려는 클래스의 가이드 읽기 (개략적인 기능에 대한 이해)
2. 참조 자료(API Reference)를 살펴보며 구현할 기능(프로퍼티)나 작동방법(메서드) 숙지

 

ex) 정말 정말 앱 개발에서 자주 쓰이는 UICollectionView를 예를 들어 보겠습니다.

먼저 우리가 사용할 class에 대한 이해가 필요하겠죠? 

UICollectionView Class로 들어가 가이드를 읽어줍니다. (어휴 벌써부터 현기증이 나네요 ㅎㅎ)

다 읽고 더 내려가 하단을 보면 Topics가 있습니다. 

CollectionView를 initializing 하는 방법부터 CollectionView의 레이아웃을 변경하는 방법까지 우리가 CollectionView를 사용하면서 찾을법한 주제들을 애플이 잘 정리해 놓은 것을 볼 수 있습니다. 우리가 찾고자 하는 내용이 여기 있다면 이를 참고해서 개발을 하면 되고 없다면 직접 API Reference로 가서 UICollectionView Class의 프로퍼티와 메서드를 찾아보면 됩니다.

만약 여기서도 찾고자 하는 프로퍼티나 메서드가 없다면?? -> 부모 클래스로 올라가서 찾아보시면 됩니다. 

마지막으로, 특정 이벤트를 감지하고 싶다면 델리게이트가 있는지 살펴보고, 만약 있다면 해당 프로토콜 문서로 이동하여 살펴봅니다.

 

어때유? 쉽죠? 저도 이제 막 문서 읽는 노력을 들이는 중이지만, 많이 귀찮고 구글링 할 때보다 시간이 더 많이 드는 건 사실인 것 같습니다 ㅜ

하지만 이러한 노력들이 하나 둘 쌓여 실력이 다져지는 거라 생각하고 우리 모두 다 같이 문서 읽는 습관을 들여봅시다!

 

<이 글을 정리하기 위해 참고한 자료>

https://www.edwith.org/boostcourse-ios/lecture/20638/

[LECTURE] 1) 애플 개발자 문서 읽기 : edwith

 

sungdoo.dev/programming/start-ios-development-with-offical-docs/

공식문서 만으로 iOS 개발 배우기 - Dev Story of Sungdoo