이 문서의 목적: RAD 스튜디오 설치, 업그레이드, 제거 방법을 설명한다.
(Docwiki에 있는 10.4 버전 설치 문서를 기반으로 작성됨. 다른 버전은 원문(영문)을 참고)

목차

1 설치하기

1.1 설치 전 확인 사항

• 시스템 요구사항은 Installation Note 참고.
• RAD 스튜디오는 이전 버전이 설치된 컴퓨터에도 새 버전을 함께 설치할 수 있다.
  • 이때, 컴퓨터의 PATH 환경 변수에 해당 버전이 추가된다.
  • 환경 변수는 최대 1830자까지만 들어갈 수 있으므로 (그럴리는 거의 없지만) 넘지 않도록 유의하기 바람

1.2 설치 파일 고르기

일반 설치파일 또는 오프라인 설치파일 중 하나를 선택한다.

일반 설치파일을 사용하는 것이 일반적인 상황에서 최고의 선택이다. 그 이유는,

• 설치 시 소요 시간이 훨씬 짧다. 설치 후 설치 요소를 다시 변경할 때도 훨씬 짧다.
• 설치 요소 선택이 더 유연하다.
  • 타겟 플랫폼과 프로그래밍 언어를 조합하여 구성 가능 (오프라인 Installer는 타겟 플랫폼과 프로그래밍 언어를 별도로 지정함)
  • 설치된 프로그래밍 언어를 설치 후에도 제거 가능
• 설치 파일 용량이 훨씬 작다.
  • 0.2GB (설치 중 선택에 맞게 필요한 파일을 자동으로 다운로드하며 설치)
• ESD 이메일 안에는 시리얼번호 뿐만 아니라 일반 설치파일 링크도 함께 들어있다.
• 설치파일을 보관할 필요가 없으며, 일단 설치되고 나면 이후에는 개발도구 안에서 설치 요소를 변경 가능하다.
• 설치 과정이 더 쉽고 명확함 (설치 단계가 훨씬 직관적임)

오프라인 설치파일을 사용해야 하는 특별한 경우도 있다. 즉,

• 인터넷에 연결되지 않은 컴퓨터에 설치해야 하는 경우
• 설치되는 드라이브에 공간이 부족하여 설치 과정에 필요한 임시 파일들을 받아들이지 못하는 경우 (오프라인 설치파일로는 설치를 위한 임시 파일 저장 폴더를 다른 곳으로 지정 가능)
• [오프라인 설치파일 사용 시 주의 사항]
  • 기능 매니저 (Tools > Manage Platform) 사용 안됨
  • 겟잇 패키지 매니저를 사용하려면, 수작업으로 "online mode"를 켜야 함
    • 방법:GetItCmd.exe 도구를 사용하여 다음 명령어 실행 GetItCmd.exe -c=useonline
    • BDS 환경 변수를 설정해 주어야 GetItCmd.exe를 사용할 수 있음
      • 명령창에서 다음 명령어 실행: 

        set BDS=C:\Program Files (x86)\Embarcadero\Studio\21.0

      • 또는 [BDS설치 폴더]\bin\rsvars.bat 명령 파일을 찾아서 실행

1.3 선택한 설치파일을 실행하여 설치하기

• 일반 설치파일: 일반 설치파일 사용하기 문서 참조
• 오프라인 설치파일: 오프라인 설치파일 사용하기 문서 참조

1.4 RAD 스튜디오 설치 후 (필요 시) 추가 조치

1.4.1 이전 버전의 설정 사항 임포트하기

이미 이전 버전이 설치되어 있는 컴퓨터라면 설정 마이그레이션 도구를 사용하여 새 버전에도 동일한 설정을 반영한다.

1.4.2 새 PA (Platform Assistant) 설치하기

맥OS 또는 iOS 용 애플리케이션을 배포할 계획이 있거나, 64비트 윈도우 애플리케이션을 원격에 배포할 계획이 있다면, 맥 또는 원격의 64비트 윈도우 시스템에 PA (Platform Assistant)를 설치해야 한다. 이때 반드시 새 버전에서 제공하는 새 PA를 설치해야 한다 (이전 버전에서 제공된 PA를 재사용할 수 없음).

• 팁! 하나의 시스템에서 버전이 다른 PA (Platform Assistant)를 동시에 실행할 수 있다. 단, 각 PA 인스턴스는 서로 다른 포트 번호를 사용해야 한다.

1.4.3 템플릿 파일 업데이트하기

맥OS, iOS, 또는 안드로이드 용 프로젝트에는 각 플랫폼별로 사용자 지정 사항을 반영할 수 있도록 템플릿 파일이 들어있다. RAD 스튜디오를 이전 버전에서 새 버전으로 마이그레이션 하려면 반드시,

1. 사용자 지정이 반영된 템플릿 파일을 백업하여 향후 변경 내용 점검을 준비한다. 
2. 프로젝트 폴더 안에 있는 템플릿 파일을 모두 제거한다.
3. 각 플랫폼 별로 만든 애플리케이션을 (안드로이드는) 빌드, (맥OS, iOS)는 배포한다. 그러면 RAD 스튜디오가 각 템플릿 파일을 최신 버전으로 자동 생성한다.
4. (사용자 지정 사항이 기존에 있었다면) 새 템플릿 파일을 편집하여 해당 변경 즉 사용자 지정 사항을 반영한다. 

보다 자세한 내용은:

• AndroidManifest.template.xml 템플릿 파일 새로 만들기
• info.plist 템플릿 파일 새로 만들기
  (info.plist.TemplateOSX.xml, info.plist.TemplateiOS.xml)
• iOS, 맥OS 용 Entitlement List(자격 목록)을 사용자 지정하기
  (Entitlement.TemplateOSX.xml, Entitlement.TemplateiOS.xml)

2 설치 후에 기능을 추가 또는 변경하기

(사용할 프로그래밍 언어, 사용할 타겟 플랫폼, 언어팩 등) 주요 기능 요소를 RAD 스튜디오 설치 중 뿐만 아니라 설치 후에도 활성화 또는 비활성화 할 수 있다.

일반 설치파일을 사용을 사용하여 설치했다면 기능 매니저(Feature Manager)를 사용하여 기능 추가 / 제거하기 의 내용을 따른다. 

오프라인 설치파일을 사용하여 설치했다면 오프라인 설치파일을 사용하여 기능 추가 / 제거하기 의 내용을 따른다. 

3 RAD 스튜디오 제거하기

관리자(Administrator) 권한이 있는 사용자는 자신이 설치했던 RAD 스튜디오를 제거할 수 있다. 윈도우10에서 프로그램 변경/제거하기 참고.

3.1 네트워크 라이선스를 사용중인 RAD 스튜디오 제거하기

RAD 스튜디오가 제거되고나면, 관리자(Administrator)가 아닌 모든 사용자는 윈도우 레지스트리에 있는 사용자의 고유 데이터를 반드시 제거해야 한다.

1. 해당 사용자 계정으로 윈도우 로그인한다.
2. 레지스트리 백업한다.
3. Regedit 또는 기타 레지스트리 편집 도구를 실행한다.
4. 해당 레지스트리 키를 삭제한다.
   (10.4 버전 기준): HKEY_CURRENT_USER\Software\Embarcadero\BDS\21.0

3.2 구성 파일 (Configuration Files) 제거

RAD 스튜디오가 제거되고나도, 디펄트 프로젝트 설정 등 사용자 고유 데이터가 구성 파일에 남는다. 따라서 아래 폴더에서 수작업으로 제거해야 한다(10.4 버전 기준).

• All Users\Application Data\Embarcadero\BDS\21.0
• All Users\Shared Documents\Embarcadero\BDS\21.0

4 RAD 스튜디오를 업그레이드하기

주의! RAD 스튜디오의 다른 버전을 설치하려면 아래 단계를 따를 필요가 없다. 버전이 다르다면 RAD 스튜디오는 동시에 같은 컴퓨터에 공존할 수 있다.

메이저 버전이 같은 RAD 스튜디오를 기능이 더 좋은 상위 에디션 또는 최신 업데이트 버전으로 (예를 들어 같은 10.4.x 버전에서 10.4.y 버전으로) 교체하려면 먼저 RAD 스튜디오를 제거하고 나서 새 에디션이나 새 업데이트를 설치해야 한다. (업데이트 시에는 해당 업데이트 설치 방법 안내가 있다면 그 내용을 따르는 것이 우선이다) 

5 관련 주제

• 겟잇 패키지 매니저를 사용하여 패키지 설치하기