GitHub Pages에 React App(SPA) 호스팅

이득규·2022년 5월 15일
0


사전 react-create-app으로 먼저 프로젝트를 생성하고 진행합니다.

서버 배포하기

gh-page 설치

	yarn add gh-pages

package.json 수정

{
  ...
  "homepage": "https://사용자아이디.github.io/프로젝트명",
  ...
  "scripts": {
    ...
    "predeploy": "yarn run build",
    "deploy": "gh-pages -d build"
  },
}
    
    

서버 배포

	yarn run deploy

github의 프로젝트에 gh-pages branch 가 현재 repository 추가 된 것을 보실 수 있을겁니다.

SPA React App 호스팅하기

윗 상태로 단순히 호스팅만 하게 된다면 새로고침? 시 에러가 뜨는데

이유는 GitHub pages 가 SPA 를 지원하지 않기 때문에 [사용자아이디].github.io/category/now_playing 와 같은 URL 을 인식하지 못하고 모두 404 page 로 뜨게 됩니다.

따라서 404.html 을 만들어서 해당 URL 을 쿼리로 만들어서 리다이렉션을 해줘야 합니다.

  • public/404.html

아래 소스는 MIT license 의 오픈 소스입니다. 프로젝트 포함시 라이센스를 명시해주세요.


<!DOCTYPE html>
<html>
  <head>
      <meta charset="utf-8">
      <title>Single Page Apps for GitHub Pages</title>
      <script type="text/javascript">
          // Single Page Apps for GitHub Pages
          // https://github.com/rafrex/spa-github-pages
          // Copyright (c) 2016 Rafael Pedicini,  licensed under the MIT License
          //  ---------------------------------------------- ------------------------
          // This script takes the current url and  converts the path and query
          // string into just a query string, and then  redirects the browser
          // to the new url with only a query string  and hash fragment,
          // e.g. http://www.foo.tld/one/two?a=b& c=d#qwe, becomes
          // http://www.foo.tld/?p=/one/two&  q=a=b~and~c=d#qwe
          // Note: this 404.html file must be at least  512 bytes for it to work
          // with Internet Explorer (it is currently >  512 bytes)

          // If you're creating a Project Pages site  and NOT using a custom domain,
          // then set segmentCount to 1 (enterprise   users may need to set it to > 1).
          // This way the code will only replace the  route part of the path, and not
          // the real directory in which the app  resides, for example:
          //  https://username.github.io/repo-name/one/two?  a=b&c=d#qwe becomes
          // https://username.github.io/repo-name/? p=/one/two&q=a=b~and~c=d#qwe
          // Otherwise, leave segmentCount as 0.
          var segmentCount = 1;

          var l = window.location;
          l.replace(
              l.protocol + '//' + l.hostname + (l.port ?   ':' + l.port : '') +
              l.pathname.split('/').slice(0, 1 +  segmentCount).join('/') + '/?p=/' +
              l.pathname.slice(1).split('/').slice  (segmentCount).join('/').replace(/&/g,  '~and~') +
              (l.search ? '&q=' + l.search.slice(1) .replace(/&/g, '~and~') : '') +
              l.hash
          );

      </script>
  </head>
  <body>
  </body>
</html>
  • public/index.html 에 아래 script를 추가해주세요

아래 소스는 MIT license 의 오픈 소스입니다. 프로젝트 포함시 라이센스를 명시해주세요.

<head>
...
  <!-- Start Single Page Apps for GitHub Pages -->
  <script type="text/javascript">
    // Single Page Apps for GitHub Pages
    // https://github.com/rafrex/spa-github-pages
    // Copyright (c) 2016 Rafael Pedicini, licensed under the MIT License
    // ----------------------------------------------------------------------
    // This script checks to see if a redirect is present in the query string
    // and converts it back into the correct url and adds it to the
    // browser's history using window.history.replaceState(...),
    // which won't cause the browser to attempt to load the new url.
    // When the single page app is loaded further down in this file,
    // the correct url will be waiting in the browser's history for
    // the single page app to route accordingly.
    (function (l) {
      if (l.search) {
        var q = {};
        l.search.slice(1).split('&').forEach(function (v) {
          var a = v.split('=');
          q[a[0]] = a.slice(1).join('=').replace(/~and~/g, '&');
        });
        if (q.p !== undefined) {
          window.history.replaceState(null, null,
            l.pathname.slice(0, -1) + (q.p || '') +
            (q.q ? ('?' + q.q) : '') +
            l.hash
          );
        }
      }
    }(window.location))
  </script>
  <!-- End Single Page Apps for GitHub Pages -->

</head>

router basename 설정

  • BrowserRouter 에 basename 을 지정을 해줍니다.

package.json

	"homepage": "https://[github 아이디].github.io/movie_app",

라우터 설정 파일

      <BrowserRouter basename='/movie_app'>
        <Routes>
			<App />
        </Routes>
      </BrowserRouter>

참조 url https://github.com/rafgraph/spa-github-pages

profile
끄적 끄적

0개의 댓글