본문 바로가기
튜토리얼

Capacitor를 이용한 Vue, Angular, React 오프라인 화면 구현

Network API 및 Capacitor을 사용해 Vue, Angular, React 애플리케이션에서 오프라인 화면을 구현하는 방법을 알아보세요. 오프라인 상황을 효과적으로 처리해 사용자 경험을 개선하세요.

Vue, Angular, React에서 Capacitor Capgo를 활용한 오프라인 화면 만들기 블로그 일러스트

Vue 3, Angular 14, React에서 오프라인 화면 만들기

이 튜토리얼에서는 Network API를 사용하여 Vue 3, Angular 14, React 애플리케이션에서 오프라인 화면을 만드는 방법을 배웁니다. Network API는 네트워크 및 연결 정보를 제공하여 오프라인 상황을 처리하고 더 나은 사용자 경험을 제공할 수 있게 합니다. 단순한 온라인/오프라인 플래그를 넘어선 더 깊은 도달성 확인을 위해, @capgo/capacitor-network-diagnostics는 네이티브 code에서 URL 도달성, TCP 포트, WebSocket 핸드셰이크를 테스트할 수 있습니다.

사전 요구사항

시작하기 전에 다음 항목이 설치되어 있는지 확인하세요:

프로젝트 설정하기

먼저 각 프레임워크에 맞는 scaffolding 도구로 새 프로젝트를 만들어 보겠습니다.

Vue 3

터미널을 열고 다음 명령어를 실행해 새 Vue 3 프로젝트를 만드세요:

vue create offline-screen-vue3

기본 preset을 선택하고 프로젝트가 생성될 때까지 기다리세요.

Angular 14

터미널을 열고 다음 명령을 실행하여 새로운 Angular 14 프로젝트를 생성하세요:

ng new offline-screen-angular14

프롬프트에 따라 진행하고, 추가 기능을 묻는 화면에서 “Routing”을 선택하려면 스페이스바 키를 누르세요. 프로젝트가 생성될 때까지 기다리세요.

React

터미널을 열고 다음 명령을 실행하여 새로운 React 프로젝트를 생성하세요:

npx create-react-app offline-screen-react

프로젝트가 생성될 때까지 기다려 주세요.

Network API 설치하기

이제 패키지를 설치해 보겠습니다. @capacitor/network 이 패키지는 Network API를 제공합니다.

터미널을 열고 프로젝트 디렉터리로 이동하세요. 그런 다음 아래 명령을 실행해 패키지를 설치하세요:

npm install @capacitor/network

Capacitor 프로젝트의 경우, 네이티브 프로젝트 파일을 동기화하려면 아래 명령도 실행하세요:

npx cap sync

다음 명령으로 Capacitor CLI의 전역 설치 여부를 확인하세요:

npm install -g @capacitor/cli

오프라인 화면 구현하기

다음으로, 각 프레임워크에서 오프라인 화면 기능을 구현합니다. 사용자가 오프라인 상태가 되면 간단한 메시지를 표시합니다.

Vue 3

Vue 3 프로젝트에서 다음 파일을 여세요: src/main.js 파일을 열고 Network 모듈을 다음에서 import하세요: @capacitor/network:

import { createApp } from 'vue';
import { Network } from '@capacitor/network';

const app = createApp(App);

// Your application setup

app.mount('#app');

Network.addListener('networkStatusChange', status => {
  if (status.connected) {
    // User is back online
    // Hide the offline screen
    document.getElementById('offline-screen').style.display = 'none';
  } else {
    // User is offline
    // Display the offline screen
    document.getElementById('offline-screen').style.display = 'block';
  }
});

const logCurrentNetworkStatus = async () => {
  const status = await Network.getStatus();
  console.log('Network status:', status);
};

애플리케이션 템플릿(App.vue)에 <div> id가 offline-screen 인 요소를 추가하여 오프라인 화면 메시지를 표시합니다:

<template>
  <div id="app">
    <div id="offline-screen">
      <h1>You are offline</h1>
      <p>Please check your internet connection and try again.</p>
    </div>
    <!-- Your application content -->
  </div>
</template>

<style>
#offline-screen {
  display: none;
  text-align: center;
  padding: 20px;
  background-color: #f2f2f2;
}

#offline-screen h1 {
  font-size: 24px;
}

#offline-screen p {
  font-size: 16px;
}
</style>

이제 사용자가 오프라인 상태가 되면 오프라인 화면이 표시됩니다. 다시 온라인 상태가 되면 오프라인 화면은 자동으로 숨겨집니다.

Angular 14

Angular 14 프로젝트에서 src/app/app.component.ts 파일을 열고 Network 모듈을 다음에서 import하세요: @capacitor/network:

import { Component } from '@angular/core';
import { Network } from '@capacitor/network';

@Component({
  selector: 'app-root',
  templateUrl: './app.component.html',
  styleUrls: ['./app.component.css']
})
export class AppComponent {

  constructor() {
    Network.addListener('networkStatusChange', status => {
      if (status.connected) {
        // User is back online
        // Hide the offline screen
        document.getElementById('offline-screen').style.display = 'none';
      } else {
        // User is offline
        // Display the offline screen
        document.getElementById('offline-screen').style.display = 'block';
      }
    });
  }

  logCurrentNetworkStatus = async () => {
    const status = await Network.getStatus();
    console.log('Network status:', status);
  };

}

애플리케이션 템플릿(app.component.html)에 <div> id가 있는 요소 offline-screen 오프라인 화면 메시지를 표시하려면:

<div id="offline-screen">
  <h1>You are offline</h1>
  <p>Please check your internet connection and try again.</p>
</div>

<!-- Your application content -->

다음 스타일을 다음 파일에 추가하세요: app.component.css 파일에 추가하세요:

#offline-screen {
  display: none;
  text-align: center;
  padding: 20px;
  background-color: #f2f2f2;
}

#offline-screen h1 {
  font-size: 24px;
}

#offline-screen p {
  font-size: 16px;
}

이제 사용자가 오프라인 상태가 되면 오프라인 화면이 표시됩니다. 다시 온라인 상태가 되면 오프라인 화면은 자동으로 숨겨집니다.

React

React 프로젝트에서 src/App.js 파일을 열고 Network 모듈을 다음에서 import하세요: @capacitor/network:

import React, { useEffect } from 'react'
import { Network } from '@capacitor/network'

function App() {

  useEffect(() => {
    Network.addListener('networkStatusChange', (status) => {
      if (status.connected) {
        // User is back online
        // Hide the offline screen
        document.getElementById('offline-screen').style.display = 'none'
      }
      else {
        // User is offline
        // Display the offline screen
        document.getElementById('offline-screen').style.display = 'block'
      }
    })
  }, [])

  const logCurrentNetworkStatus = async () => {
    const status = await Network.getStatus()
    console.log('Network status:', status)
  }

  return (
    <div id="app">
      <div id='offline-screen'>
        <h1>You are offline</h1>
        <p>Please check your internet connection and try again.</p>
      </div>
      {/* Your application content */}
    </div>
  )

}

export default App

다음 스타일을 다음 파일에 추가하세요: App.css 파일에 추가하세요:

#offline-screen {
  display: none;
  text-align: center;
  padding: 20px;
  background-color: #f2f2f2;
}

#offline-screen h1 {
  font-size: 24px;
}

#offline-screen p {
  font-size: 16px;
}

이제 사용자가 오프라인 상태가 되면 오프라인 화면이 표시됩니다. 다시 온라인 상태가 되면 오프라인 화면은 자동으로 숨겨집니다.

지원되는 메서드와 인터페이스

Network API는 네트워크 연결 관리를 돕는 다양한 메서드와 인터페이스를 제공합니다. 주요 항목은 다음과 같습니다:

Vue, Angular, React에서 Capacitor와 함께 오프라인 화면 이어가기

사용 중이라면 Capacitor를 이용한 Vue, Angular, React 오프라인 화면 구현 네이티브 미디어 및 인터페이스 동작을 계획하려면, 이를 다음 항목과 연결하세요: @capgo/capacitor-live-activities 사용 @capgo/capacitor-live-activities 사용에서의 네이티브 기능, @capgo/capacitor-live-activities @capgo/capacitor-live-activities의 구현 세부 사항, @capgo/capacitor-video-player 사용 @capgo/capacitor-video-player 사용 시 네이티브 기능은, @capgo/capacitor-video-player 구현 세부 사항은 @capgo/capacitor-video-player에서 확인하고, @capgo/capacitor-native-navigation 사용하기 @capgo/capacitor-native-navigation. 사용 시의 Native 기능

Capacitor 앱용 Live updates

웹 레이어 버그가 라이브 상태라면, 앱 스토어 승인을 며칠씩 기다리지 말고 Capgo를 통해 수정 사항을 배포하세요. 네이티브 변경 사항은 정상 리뷰 절차를 그대로 따르는 반면, 사용자는 백그라운드에서 업데이트를 받습니다.

블로그 최신 글

Capgo는 정말 프로페셔널한 모바일 앱을 만드는 데 필요한 최고의 인사이트를 제공합니다.