알려진 문제

AppStudio를 사용할 때 발생할 수 있는 동작과 이러한 문제를 해결하기 위해 수행할 수 있는 알려진 대안이나 실행 조치가 아래에 나와 있습니다.

AppStudio의 버그에 대해 보고하거나 자세히 알아보려면 지원을 방문하세요.

설치 및 설정

앱 구성 및 확장

설치 파일 생성

스토어 제출

설치 및 설정

Linux .run 파일을 더블 클릭하면 Ubuntu Software Center를 불러오고 오류 메시지가 표시됩니다. 이유가 무엇입니까?

인터넷에서 .run 파일을 다운로드하면 해당 실행 권한이 비활성화됩니다. 해당 권한을 활성화하려면 다음을 수행하세요.

  1. .run 파일을 마우스 오른쪽 버튼으로 클릭합니다.
  2. 권한 탭으로 이동합니다.
  3. 파일을 프로그램으로 실행 허용 체크 박스를 선택합니다.
  4. 닫기를 클릭합니다.

이제 .run 파일을 더블 클릭하면 설치 마법사가 시작됩니다.

ArcGIS AppStudio를 시작할 수 없으며 api-ms-win-crt-runtime-l1-1-0.dll 파일이 누락되었다는 오류 메시지가 나타납니다.

이 메시지는 AppStudio 실행에 필요한 Windows 유니버설 C 런타임 컴포넌트가 없음을 나타냅니다. 이러한 컴포넌트는 Windows 지원에서 다운로드할 수 있는 Windows 업데이트에서 배포되었습니다.

ArcGIS AppStudio를 현장에서 사용할 수 있지만 사무실에서는 사용할 수 없습니다.

가장 큰 이유는 사무실에서 인터넷 접근이 규칙 기반의 자동 구성 스크립트를 통해 제어되기 때문입니다. 이 프록시 양식은 현재 AppStudio에서 감지되지 않아 앱의 ArcGIS Online 연결 기능에 영향을 줄 수 있습니다. 이 경우 자동 구성 스크립트를 끄고 주소 및 포트 조합을 통해 프록시 서버를 수동으로 구성해야 할 수 있습니다.

Windows의 경우 해당 프로세스를 제어하는 옵션은 인터넷 옵션LAN 설정에 있습니다.

AppStudio 콘솔에서 콘솔 로그가 수신되지 않습니다.

콘솔 도구에서 표시하는 UDP(User Datagram Protocol) 메시지가 방화벽에 의해 필터링되거나 차단되고 있기 때문입니다. 이 문제는 콘솔 도구를 사용하는 중에는 방화벽을 끄거나 UDP 패킷에 대한 예외를 허용함으로써 해결할 수 있습니다. 또는 더욱 신뢰할 수 있는 네트워크의 경우 방화벽을 재설정하고 인증 질문 메시지가 나타날 때 UDP 패킷이 허용되도록 선택함으로써 해결할 수 있습니다.

ArcGIS Runtime 앱이 Windows에서 충돌합니다.

Windows 머신의 그래픽 드라이버가 최소 요구 사항을 충족하지 못한 경우 이 문제가 발생할 수 있습니다. ArcGIS Runtime 앱 실행 시 2D 맵 뷰의 최소 요구 사항은 OpenGL 2.1이며 3D 씬 뷰의 최소 요구 사항은 3.2입니다. 사용 가능한 최신 드라이버를 사용하는 것을 권장합니다.

Android 가상 기기를 생성하여 앱을 테스트할 수 없습니다.

가상 머신을 사용하여 여러 플랫폼에서 앱을 테스트하는 경우에는 이러한 가상 머신에서 Android Emulator를 실행할 수 없습니다. 이는 Android Emulator가 중첩된 가상 머신을 지원하지 않는 시각화 엔진인 HAXM(Hardware Accelerated Execution Manager)을 사용하기 때문입니다. Android Emulator는 실제 머신에서만 실행할 수 있습니다.

Android Studio를 설치했는데 AppStudio에서 인식되지 않습니다.

처음에 AppStudioAndroid Studio의 기본 위치에 있는 파일을 검색합니다. Android SDK 위치가 Qt Creator에 구성되어 있는 경우 AppStudio에서는 이 위치를 대신 사용합니다.

각 플랫폼의 SDK 기본 경로는 다음과 같습니다.

  • Windows: Users/YourName/AppData/Local/Android/sdk
  • macOS: ~/Library/Android/sdk
  • Linux: ~/Android/Sdk

가상 기기 목록을 채우는 데 사용된 파일은 다음 폴더에 있어야 합니다.

  • AVD 구성은 ~/.android 아래의 하위 디렉터리에서 확인됩니다.
  • Emulator 인증 코드는 ~/.emulator_console_auth_token에서 확인됩니다.
  • adb 커맨드 경로는 <SDKPATH>/platform-tools/adb입니다.
  • Emulator 커맨드 경로는 <SDKPATH>/tools/emulator입니다.

텍스트 음성 변환은 iOS 14에서 아랍 음성으로 제공됩니다.

iOS 14 이상을 실행하는 기기에서는 모든 텍스트 음성 변환의 음성을 기기에서 기본적으로 사용할 수 있는 것은 아닙니다. 그 결과로, 알람이 소리 내어 읽히면 일반적으로 아랍어 같이 예상치 못한 언어가 들릴 수 있습니다.

음성 파일은 기기에 수동으로 다운로드할 수 있습니다. 다운로드하려면 설정 > 접근성 > 음성 전달 > 음성 > 목소리로 이동하고 기기의 언어에 일치하는 목소리 중 하나를 다운로드합니다. 기기의 언어는 설정 > 일반 > 언어 및 지역 > iPhone 언어를 눌러 찾을 수 있습니다.

다음에 AppStudio Player 또는 빌드한 앱이 시작될 때 다운로드한 목소리를 사용합니다.

AppStudio 5.0 앱이 Ubuntu에서 시작되지 않습니다.

AppStudio 5.0으로 제작된 앱의 경우 Ubuntulibxcb-xinerama0 패키지가 설치되어 있어야 합니다. 이 패키지를 설치하려면 터미널 창에서 sudo apt update을 실행한 다음 sudo apt install libxcb-xinerama0을(를) 실행합니다. 이 패키지가 설치되었는지 확인하기 위해 apt list libxcb-xinerama0을(를) 실행합니다.

AppStudio 로그인 대화상자가 Ubuntu 22.04에서 흰색 화면으로 나타납니다.

로그인 대화상자가 이 Ubuntu 버전에서 표시되도록 하려면 환경 변수 QTWEBENGINE_DISABLE_SANDBOX을(를) 1로 설정해야 합니다. 이 환경 변수를 설정하려면 터미널 창에서 export QTWEBENGINE_DISABLE_SANDBOX=1을(를) 실행합니다. 환경 변수가 설정되었는지 확인하려면 printenv | grep QTWEBENGINE_DISABLE_SANDBOX을(를) 실행하고 QTWEBENGINE_DISABLE_SANDBOX=1이 반환되는지 확인합니다.

앱 구성 및 확장

기존의 빠른 보고서 앱이 실행되지 않고 존재하지 않는 등록정보 onComposeError에 배정할 수 없음이라는 오류 메시지가 표시됩니다.

AppStudio 4.3부터는 이메일 작성자의 오류 시그널링이 변경되었습니다.

오류를 해결하려면 Qt Creator에서 앱을 열고 LandingPage.qml 파일로 이동한 다음 onComposeErroronErrorChanged로 변경하세요(655행).

3D 씬 뷰어 템플릿 앱에서 씬 레이어를 식별할 수 없습니다.

이 알려진 문제는 향후 출시 버전에서 수정될 예정입니다.

SQL 쿼리가 실패하며 데이터베이스 테이블이 현재 잠겨 있거나 연결이 아직 사용 중이라고 보고됩니다.

이는 첫 번째 쿼리가 완료되기 전에 AppFramework.SQLQuery 컴포넌트를 사용하는 두 번째 쿼리가 시작될 때 발생하는 두 가지의 다른 오류입니다. 이러한 오류는 finish 메서드를 통해 첫 번째 쿼리의 남은 모든 결과가 필요하지 않음을 앱에 알리거나 모든 결과가 next 메서드에 대한 반복 호출을 통해 요청된다는 것을 확인함으로써 방지할 수 있습니다.

AppFramework.SecureStorage valuesetValue 메서드가 macOS의 내 앱에서 다음 오류를 반환합니다. 입력한 사용자 이름 또는 암호구가 올바르지 않습니다.

SecureStorage 및 ArcGIS Runtime 모듈을 사용하는 macOS용으로 제작된 앱이 시스템 키체인에 접근하려면 서명되어야 합니다. 자세한 내용은 macOS 앱 서명을 참고하세요.

Android에서 SwiftKey 키보드를 사용하는 경우 앱이 예기치 않게 작동합니다.

이 알려진 Qt 문제는 향후 릴리즈에서 수정될 예정입니다. 앱에서 예측 텍스트가 사용되는 경우 SwiftKey 키보드를 사용하면 입력 및 계산이 잘못 표시될 수 있습니다. Enter 키를 사용하면 SwiftKey 키보드가 다시 열리지 않을 수 있습니다.

TiledLayer 또는 VectorTiledLayer 유형의 맵에 잘못된 apiKey를 전달하면 맵은 표시되지만 예상과는 다른 스타일로 표시됩니다.

잘못된 apiKey가 전달된 경우 TiledLayer 또는 VectorTiledLayer 맵은 계속 표시되지만 기본 스타일만 표시됩니다. 사용자 설정 스타일에는 올바른 apiKey가 필요합니다.

설치 파일 생성

인증서를 제공하지 않고는 iOS에서 앱을 만들 수 없습니다.

다른 플랫폼과는 달리 iOS 앱은 테스트용이라 하더라도 서명된 프로덕션 인증서가 있어야 만들 수 있습니다. 이 인증서가 없는 상태로 만들려고 하면 오류가 발생합니다. 이러한 인증서를 가져와 유지 관리하는 방법은 Apple 앱 배포 가이드의 서명 자산 유지 관리를 참고하세요. 또한 적합한 번들 ID를 앱에 배정해야 합니다. 이 작업은 AppStudio 측면 패널에 있는 설정 창을 연 다음 플랫폼 머리글 아래의 iOS 탭으로 이동하여 수행할 수 있습니다. 자세한 내용은 iOS 앱 서명을 참고하세요.

프로비저닝 프로파일 "ABC"의 앱 ID가 "com.abc.xyz"이며 번들 ID인 "com.xyz.abc"와 일치하지 않음이라는 빌드 오류 메시지를 수신했습니다.

이 오류는 iOS 번들 ID가 설정되지 않았음을 나타냅니다. 설정 > 플랫폼 > iOS > 번들 ID로 이동하고 번들 ID가 프로비저닝 프로파일의 ID와 일치하는지 확인하세요.

프로비저닝 프로파일이 "ABC" 프로파일이 아님이라는 빌드 오류 메시지를 수신했습니다.

이 오류 메시지는 선택한 배포 방식이 빌드 요청에서 제공된 프로비저닝 프로파일의 유형과 일치하지 않음을 나타냅니다. 설정 > 플랫폼 > iOS > 배포 방식으로 이동하고 배포 방식이 빌드 요청에서 사용할 프로비저닝 프로파일의 유형과 일치하는지 확인합니다.

코드 서명 오류: 프로비저닝 프로파일 "ABC"가 서명 인증서 "DEF"를 포함하지 않음이라는 빌드 오류 메시지를 수신했습니다.

이 오류는 앱을 빌드하는 데 사용한 프로비저닝 프로파일에 정보가 누락되었음을 나타냅니다. 앱을 빌드하는 데 사용한 p12 파일에 인증서와 비공개 키가 둘 다 포함되어 있어야 합니다.

코드 서명 오류: 프로비저닝 프로파일 "ABC"가 Associated Domains 기능을 지원하지 않음이라는 빌드 오류 메시지를 수신했습니다.

이 오류는 앱이 다른 앱에서 사용할 용도로 developers.apple.com에 등록되지 않은 앱에 대한 링크를 정의함을 나타냅니다. 자세한 내용은 앱 및 웹사이트가 콘텐츠에 연결하도록 허용에 있는 Apple의 문서를 참고하세요.

잘못된 Android 서명 매개변수라는 빌드 오류 메시지를 수신했습니다.

이전 시도와 다른 머신에서 앱을 빌드하려고 하는 경우 이 오류가 나타날 수 있습니다. KeyStore 파일이 앱 항목 내에 저장되지 않으며, 그 위치에 대한 참조만 항목에 저장됩니다. 올바른 KeyStore 파일에 대한 접근 권한이 있는지 확인하려면 설정 > 플랫폼 > Android로 이동하고 KeyStore 파일에 대한 경로 및 키 별칭이 올바른지 확인합니다.

스토어 제출

오류 ITM-90717: 잘못된 App Store 아이콘으로 인한 스토어 거부.

이 오류는 앱 아이콘에 투명한 픽셀이나 알파 채널이 있기 때문에 발생합니다. 아이콘에서 이러한 항목을 제거하고 앱 설치 파일을 다시 빌드한 다음 스토어에 다시 제출하세요. 이 제한은 iOS App Store에만 적용됩니다. 다른 플랫폼에서는 앱 아이콘에 투명한 항목이 허용됩니다. 프로젝트의 appinfo.json 파일을 편집하여 플랫폼별 앱 아이콘을 지정할 수 있습니다. AppStudio의 갤러리에서 앱을 선택하고 편집을 클릭합니다. appinfo.json 파일을 선택하고 다음 예시와 유사하게 각 플랫폼에 대해 resources 요소가 appIcon 등록정보를 포함하도록 편집합니다.

"resources": {

        "android": {
            "appIcon": "assets/android_appicon.png"
        },

        "ios": {
            "appIcon": "assets/ios_appicon.png"
        },

        "linux": {
            "appIcon": "linux_appicon.png"
        },

        "macos": {
            "appIcon": "mac_appicon.png"
        },

        "windows": {
            "appIcon": "windows_appicon.png"
        },

        "appIcon": "allNotSpecifiedOperatingSystems_appicon.png"

},

제공된 번들 ID(iOS) 또는 패키지 이름(Android)이 잘못되었습니다.

App Store 항목을 생성할 경우 앱에 대한 고유 식별자를 정의해야 합니다. 이 식별자는 일반적으로 com.yourdomain.appname 형식입니다. 설정 > 플랫폼 > Android 또는 설정 > 플랫폼 > iOS에 있는 것과 동일한 식별자를 입력해야 합니다. 고유 식별자를 입력한 후에는 적용을 클릭하고 빌드를 요청하기 전에 앱을 ArcGIS 기관에 업로드해야 합니다.

최적화되지 않은 APK에 대한 경고 메시지입니다.

Google Play에 APK를 업로드하는 경우 최적화되지 않은 APK라는 오류 메시지와 앱 번들 사용 추천을 받을 수 있습니다. 이는 경고이며 Google Play에 앱을 발행하는 절차를 계속하지 못하도록 제외하지는 않습니다. AppStudio는 향후에 앱 번들을 지원할 예정입니다.