대부분의 Xcode 프로젝트 유형은 개발자가 기존 파일 형식이 빌드되는 방식을 수정하고 새 파일 형식이 빌드되는 방식을 정의할 수 있는 빌드 규칙을 지원합니다. J2ObjC 스크립트는 Xcode와 같은 빌드 시스템에 연결되도록 의도적으로 설계되었습니다.
j2objc-sample-reversi 프로젝트는 간단한 iOS 게임에 자바 소스를 추가하는 방법의 예입니다.
최소 빌드의 경우 빌드 설정을 업데이트한 다음 J2ObjC 빌드 규칙을 추가해야 합니다.
빌드 설정 업데이트
- 프로젝트 탐색기에서 프로젝트를 클릭하여 프로젝트 편집기를 열고 애플리케이션 타겟이 선택되어 있는지 확인합니다.
- Build Settings(빌드 설정) 탭을 클릭합니다.
- 기타 링커 플래그에
-ljre_emul
를 추가하여 JRE 에뮬레이션 라이브러리 (jre_emul
)를 연결합니다. 다음과 같이 표시됩니다. - + 기호를 클릭하고 사용자 정의 설정 추가를 선택합니다.
- 설정 이름을
J2OBJC_HOME
로 지정하고 값을 J2ObjC의 위치로 설정합니다. 이 폴더는 release zip의 압축을 풀어 얻은 폴더 또는j2objc/dist
폴더(소스에서 컴파일하고 루트가j2objc
인 경우)여야 합니다. - 검색 경로에서 다음을 수정합니다.
- 프레임워크 검색 경로에
${J2OBJC_HOME}/frameworks
추가 - Library Search Paths (라이브러리 검색 경로)는 각 빌드 구성에 대해
${J2OBJC_HOME}/lib
를 추가합니다. - 사용자 헤더 검색 경로에
${J2OBJC_HOME}/include
를 추가합니다.
- 프레임워크 검색 경로에
J2OBJC_HOME
을 검색하여 설정을 확인하세요. 다음과 같이 표시됩니다.
J2ObjC 빌드 규칙 추가
$source-root
이라고 부르는 자바 소스 파일의 루트 디렉터리를 결정합니다. 루트 디렉터리는 소스 파일의 최상위 패키지가 포함된 디렉터리입니다.git을 사용하고 다른 git 프로젝트에서 자바 파일을 가져오려면 자바 소스로 프로젝트를 추적하는 하위 모듈을 추가합니다. 예를 들어 Xcode 프로젝트 (xcodeproj)가
~/dev/MyProject
에 있고 Objective-C 소스가 있는 다른MyProject
디렉터리가 있을 수 있습니다.~/dev/MyProject/MyProject
디렉터리에서git submodule add git@github.com:user/javaproject
을 실행하여 Objective-C 소스와 자바 프로젝트 소스가 포함된~/dev/MyProject/MyProject/javaproject
디렉터리를 만듭니다. 그런 다음 이 폴더를 파일 시스템을 미러링하는 Xcode가 있는MyProject
그룹 아래의 Xcode 프로젝트로 드래그하면 됩니다.${PROJECT_DIR}/MyProject/javaproject/src
는$source-root
입니다.자바 소스가 Xcode 프로젝트의 그룹 또는 디렉터리에 있으면
$source-root
은${PROJECT_DIR}/__group_or_directory_name__
입니다.확실하지 않다면 해당 그룹이나 디렉터리를 마우스 오른쪽 버튼으로 클릭하고 Finder에서 보기를 선택하여 디렉터리를 확인하고 절대 경로를 사용하세요.
예를 들어
~/myproject/src
라는 디렉터리에 자바 패키지foo.bar
이 있다면 이 패키지의 자바 파일은~/myproject/src/foo/bar/**.java
에 있어야 합니다. 즉,~/myproject/src
가 프로젝트의 루트 디렉터리입니다.자바 소스 파일이 Xcode 프로젝트 외부에 있는 경우 터미널 창에 파일을 나열할 때 사용된 전체 경로를 입력합니다.
프로젝트 탐색기에서 프로젝트를 클릭하여 프로젝트 편집기를 열고 애플리케이션 타겟이 선택되어 있는지 확인합니다.
빌드 규칙 탭을 클릭합니다.
+를 클릭하여 빌드 규칙을 추가합니다.
새 규칙의 프로세스 옵션에서 'Java source files'를 선택합니다. 사용 옵션은 '맞춤 스크립트:'여야 합니다.
맞춤 스크립트 텍스트 상자에 다음을 추가합니다 (
$source-root
을 대체해야 함).if [ ! -f "${J2OBJC_HOME}/j2objc" ]; then echo "J2OBJC_HOME is not correctly defined, currently set to '${J2OBJC_HOME}'"; exit 1; fi; "${J2OBJC_HOME}/j2objc" -d ${DERIVED_FILE_DIR} -sourcepath "$source-root" --no-package-directories -g ${INPUT_FILE_PATH};
출력 파일 패널에서 + 버튼을 클릭하고
${DERIVED_FILE_DIR}/${INPUT_FILE_BASE}.h
를 추가합니다.+ 버튼을 다시 클릭하고
${DERIVED_FILE_DIR}/${INPUT_FILE_BASE}.m
를 추가합니다.
작업을 마치면 설정 패널은 다음과 같이 표시됩니다 (참고: 10.2부터는 이전 버전과의 호환성을 위해 Xcode에서 DERIVED_FILES_DIR과 동일한 DERIVED_FILE_DIR 변수를 계속 정의합니다.
추가 라이브러리 연결
링크 빌드 단계 (Xcode의 '바이너리를 라이브러리와 연결' 빌드 단계)에는 J2ObjC 관련 플래그가 필요합니다. 이 플래그는 애플리케이션에서 변환된 자바 클래스를 사용하는 방식에 따라 달라집니다. 전체 목록은 필수 링크 설정을 참조하세요. 다음은 연결해야 하는 추가 라이브러리를 보여주는 예입니다.
java.util.zip
패키지를 사용하려면-ljre_zip
를 기타 링커 플래그에 추가하여 libz.dylib 라이브러리를 연결해야 합니다.- 안전한 해시 생성을 수행하려면 프로젝트에 보안 프레임워크를 추가해야 합니다.
빌드 문제 디버깅
Xcode에서 이 단계를 통해 빌드 실패를 보고하면 Issue Navigator를 열고 오류를 클릭하여 세부정보를 검사합니다. 이렇게 하면 실행된 명령줄 명령문에 대한 세부정보가 표시됩니다. 다음은 몇 가지 일반적인 오류입니다.
Class not be resolve: 사용한
$source-path
가 잘못되었을 가능성이 높습니다. 실행된 명령어에서-sourcepath
옵션을 찾아 자바 소스 파일의 루트 디렉터리를 가리키는지 확인합니다.'JreEmulation.h' 파일을 찾을 수 없음 - 사용자 헤더 검색 경로 값이 잘못되었을 가능성이 높습니다. 빌드 명령어에서 경로와 함께
-I
옵션을 검색합니다. 괜찮으면 -I가 아닌 경로를 복사하고 터미널 창에서 이 경로로ls
를 실행하여 오타가 없는지 확인합니다."_IOSClass_FromClass", reference from: 또는 "_OBJCCLASS$_Java" - 라이브러리 검색 경로가 잘못되었거나 기타 링커 플래그를
-ljre_emul
로 설정하여 JRE 에뮬레이션 라이브러리를 연결하는 것을 잊었습니다. 추가 라이브러리를 연결해야 할 수도 있습니다.정의되지 않은 기호: _iconv*: 필수 iconv 라이브러리의 링크입니다.
문제가 계속되면 j2objc-discuss group에 문의하세요.