넥사크로 N은 넥사크로플랫폼 17에서 작성한 프로젝트를 그대로 사용할 수 있습니다. 넥사크로플랫폼 17 또는 14 환경에서 넥사크로 N으로 이전할 때 참고할 내용을 정리했습니다.
X-API, nexacro-xeni
넥사크로플랫폼 17 버전 X-API, nexacro-xeni 호환성 유지
넥사크로플랫폼 17 애플리케이션과 연결해 사용하던 X-API, nexacro-xeni 서비스는 기존 버전 그대로 사용할 수 있습니다. 추가된 기능을 사용할 필요가 있는 경우에는 넥사크로 N 버전의 X-API, nexacro-xeni를 사용하고 그렇지 않은 경우에는 기존 서비스를 그대로 사용할 수 있습니다.
17 버전 서버 라이선스 파일
운영 서비스 환경(도메인, 대상 범위 등)이 기존과 같다면 서버 라이선스 파일을 교체할 필요는 없습니다. 넥사크로 N 애플리케이션에서 기존 17 버전 서버 라이선스 파일을 계속 사용할 수 있습니다.
넥사크로 N 버전 X-API, nexacro-xeni 업데이트가 필요한 경우
넥사크로 N에 추가된 기능 사용 시에는 넥사크로 N X-API, nexacro-xeni를 설치하고 서버 측 코드 일부를 수정해주어야 합니다.
데이터 송수신 시 JSON 형식을 지원
PlatformType.CONTENT_TYPE_JSON 상수를 지원합니다.
서버 설정/개발 가이드문서의 데이터 송수신 항목을 참고해주세요.
패키지명 변경
아래와 같이 패키지명이 변경됐습니다. 서버 측 코드에서 import 문에 대한 수정이 필요합니다.
com.nexacro17.xapi.data > com.nexacro.java.xapi.data com.nexacro17.xapi.tx > com.nexacro.java.xapi.tx
N 버전 서버 라이선스 파일
N 버전 X-API, nexacro-xeni 업데이트 시에는 N 버전 서버 라이선스 파일을 사용해야 합니다.
넥사크로플랫폼 17 > 넥사크로 N
프로젝트 특성에 따라 일부 자동 변경이 발생할 수 있고 그대로 사용할 수 있습니다.
TypeDefinition
아래와 같은 경우 TypeDefinition 일부 내용이 변경됩니다.
TypeDefinition 내 bs, metadata 타입 서비스를 등록한 경우
Service 항목 내 DatasetLayout 속성명이 DataSchema으로 변경됐습니다.
해당 타입 서비스가 있는 경우 프로젝트를 열 때 TypeDefinition version 정보가 3.0으로 변경되며 DatasetLayout 속성명을 DataSchema으로 수정합니다.
기존 TypeDefinition 파일은 백업 파일로 생성합니다. 넥사크로 N에서 다시 넥사크로플랫폼 17로 돌아가야 하는 경우 해당 백업 파일로 typedefinition.xml 파일을 대체해줍니다(넥사크로 N 버전에서 추가적인 작업을 진행한 경우에는 넥사크로플랫폼 17로 돌아가는 것을 보장하지 않을 수 있습니다).
Theme
넥사크로 N 기본 테마가 변경됐지만 넥사크로플랫폼 17에서 사용하던 테마는 그대로 사용할 수 있습니다.
각 버전에서 제공하는 기본 테마는 아래와 같습니다.
넥사크로플랫폼 17 (17.1.3.700 기준) | 넥사크로 N |
|---|---|
android.xtheme default.xthme (기본 테마) default_RTL.xtheme ios.xtheme macos.xtheme windows.xtheme | blue.xtheme (기본 테마) blue_mobile.xtheme gray.xtheme gray_mobile.xtheme |
Bootstrap Customize
넥사크로플랫폼 17에서 Bootstrap Customize 기능을 사용해 파일을 수정한 경우에는 자동으로 넥사크로 N 버전에 맞게 변환해주지 않습니다.
기존 DOCTYPE 태그를 주석으로 막아주고 #{DOCTYPE} 코드를 추가해주세요.
IE8, 9 버전 지원 중단
넥사크로 N 버전에서 Generate, Deploy 시 IE8, 9 버전에 대한 지원이 중단됐습니다. IE8, 9 버전 사용자에 대한 지원을 계속해야 하는 경우에는 넥사크로 N 버전으로 이전을 권장하지 않습니다.
클라이언트 라이선스 파일
WRE 배포 시에도 클라이언트 라이선스 파일을 설정해주어야 합니다.
안드로이드 운영체제 NRE 라이브러리 변경
넥사크로 N에서 제공하는 안드로이드 운영체제 NRE 라이브러리가 Android Jetpack 기반으로 변경됐습니다. 안드로이드 스튜디오에서 프로젝트를 생성하고 라이브러리를 설정하는 경우 넥사크로플랫폼 17보다 간단하게 설정할 수 있습니다.
앱 배포 가이드 문서의 넥사크로 라이브러리 설정 항목을 참고해주세요.
넥사크로플랫폼 14 > 넥사크로 N
넥사크로플랫폼 14 프로젝트는 마이그레이션을 지원합니다.
마이그레이션
개발도구 가이드 문서의 마이그레이션 항목을 참고해주세요.
넥사크로 N > 넥사크로플랫폼 17
상위 버전에서 생성한 프로젝트를 하위 버전으로 옮기는 것은 권장하지 않습니다. 프로젝트 로딩 시 아래와 같은 메시지를 표시하고 프로젝트 로딩 실패로 처리합니다.