Hosting Documentation

• Xcode 13에 build Documentation기능 추가
• 이걸 export해서, 다른 사람의 Xcode서 보거나, 온라인으로 호스팅할 수 있다.
  • export의 결과물인 documentation archive는 Xcode용 데이터와 웹용 데이터를 둘 다 가지는 컨테이너다.
  • 웹쪽은 단일 페이지를 가진 vue.js 웹앱이다.
• 서버가 핸들링 해야 하는 요청
  • documentation이나 tutorial page 자체를 읽기 위한 요청({host}/documentation/, {host}/tutorials/)
  • archive내의 리소스 요청
• 요청 과정
  • 요청이 documentation이나 tutorial로 시작할 경우, index.html을 반환한다.
  • index.html은 css와 js 파일을 가리키고 있고, 이를 다시 서버에 요청한다. 이제 웹 앱이 된다.
  • 이후 추가로 가리키고 있는 리소스들을 요청한다.

Automating builds

• xcodebuild 커맨드 라인으로 자동화하자.

xcodebuild docbuild \
	-scheme SlothCreator \
	// output path
	-derivedDataPath MyDerivedDataFolder

find MyDerivedDataFolder
	-name "*.doccarchive"
	-exce cp -R {} ~www \;