VIZWing Document Help

Development Environment

Android 버전

API Level

최소 사양

Android 버전 8.0 ("Oreo") 이상

API 26 이상

\[VIZCore.aar] 활용하여 Android 모바일에서 실행 가능한 뷰어를 개발할 수 있도록 한다.

\[VIZCore.aar\] 다운로드

Git Hub (VIZWingDemo)

Android Studio 설치

프로젝트 생성

  • 1. [Android Studio] 실행

  • 2. [File] -> [New] -> [New Project...]

  • 3. [Empty Views Activity] 생성

Figure 1 : File -> New -> New Project...

guide_create_001.png
    • 4. Name 설정 ex)VIZWingDemo

    • 5. Package Name 설정 ex)net.softhills.vizwingdemo

    • 6. [Language]를 'Java' 로 설정

    • 7. [Minimum SDK]를 'API 26 ("Oreo"; Android 8.0)' 이상으로 설정

    • 8. [Build configuration language]를 'Groovy DSL (build.gradle)' 로 설정

    Figure 2 : 프로젝트 생성

    guide_create_002.png
      • 9. [VIZCore.aar] 을 <경로> [.\app\libs] 에 추가

      Figure 3 : 라이브러리 추가

      guide_create_003.PNG

        개발 환경 구축

        AndroidManifest.xml

        • 1. 권한 설정 추가

        • - 파일 저장 공간

        • - 인터넷 (라이선스 인증을 위해 필요)

        • - 카메라 (AR 기능 사용을 위해 필요)

        • 2. AR 기능 추가 (AR 기능 사용을 위해 필요)

        Figure 4 : AndroidManifest.xml

        guide_manifest_001.png

          Build.gradle

          • 1. [compileSdk], [targetSdk] "34"로 변경

          • 2. 라이브러리 추가

          Figure 5 : Build.gradle

          guide_gradle_001.png

            Viewer 화면 생성 (LocalViewActivity)

            Figure 6 : LocalViewActivity.java

            guide_add_localview_001.PNG
            guide_add_localview_002.PNG

              VIZM/VIZX 파일 목록 받아오기

              activity_main.xml

              • 1. VIZM/VIZX 파일 목록을 보여줄 <ListView> 생성

              Figure 7 : <ListView>생성

              guide_main_001.png

                MainActivity.java 수정

                • 1. 권한 설정

                • 1-1. 변수 설정

                Figure 8 : 변수 설정

                guide_main_002.png
                  • 1-2. 권한 설정 관련 함수

                  Figure 9 : 권한 설정 관련 함수

                  guide_main_004.png
                    • 1-3. 권한 설정

                    Figure 10 : 권한 설정

                    guide_main_003.png
                      • 2. VIZM/VIZX 파일 목록 읽어오기

                      • 2-1. 변수 설정

                      Figure 11 : 변수 설정

                      guide_main_005.png
                        • 2-2. Adapter 구현

                        Figure 12 : Adapter 구현

                        guide_main_006.png
                          • 2-3. VIZM/VIZX 파일 목록 읽기 & 클릭 이벤트 구현

                          Figure 13 : VIZM/VIZX 파일 목록 읽기 클릭 이벤트 구현

                          guide_main_007.png

                            모델 열기

                            activity_local_view.xml 수정

                            Figure 14 : <FrameLayout> 생성

                            guide_model_001.png

                              LocalViewActivity.java 수정

                              • 1. 콜백 함수 설정

                              Figure 15 : 콜백 함수 설정

                              guide_model_002.png
                                • 2. 모델 열기

                                Figure 16 : 모델 열기

                                guide_model_003.png

                                  최종 화면

                                  guide_view_001.png
                                  guide_view_002.png
                                    Last modified: 15 7월 2024