基於 Electron + React 的超高顏值喜馬拉雅客戶端 - Mob 誕生記

zenghongtu發表於2019-05-13

前言

最近一個月沉迷喜馬拉雅無法自拔,聽相聲、段子、每日新聞,還有英語聽力,摸魚學習兩不誤。上班時候苦於沒有桌面端,用網頁版有些 bug,官方也不搞一個,只好自己動手了。樣式參考了一下 Moon FM /t/555343,顏值還過得去,自我感覺挺好 ???

簡介

Mob(モブ), 異能超能 100的男一號。

GitHub: zenghongtu/Mob

基於 Electron, Umi, Dva, Antd 構建

功能及 UI

基於 Electron + React 的超高顏值喜馬拉雅客戶端 - Mob 誕生記

目前實現的功能有這些:

  • 一個基本的音樂播放器
  • 每日必聽
  • 推薦
  • 排行榜
  • 分類
  • 訂閱
  • 聽過
  • 下載聲音
  • 搜尋專輯

技術選型

技術棧:

之所以選擇 Umi 是因為在之前專案中研究過其部分原始碼,開發體驗感不錯,而且 bug 也少。 還有一個原因是我在找模板的過程中,看到這個大佬的模板wangtianlun/umi-electron-typescript,就直接拿來用了,大大減少了我搭建開發環境的時間,在此表示感謝~

如果你對 Umi 和 Dva 不熟,牆裂建議去學一下,分分鐘就可以上手,而且開發效率要提高的不要太多。

開發篇

React Hooks 使用問題

在開發中,所有元件、頁面都是使用 React Hooks 進行開發的。而讓我覺得最難以琢磨的一個 hooks 非 useEffect 莫屬。

// ...
useEffect(() => {
  ipcRenderer.on("HOTKEY", handleGlobalShortcut);
  ipcRenderer.on("DOWNLOAD", handleDownloadStatus);
  return () => {
    ipcRenderer.removeListener("HOTKEY", handleGlobalShortcut);
    ipcRenderer.removeListener("DOWNLOAD", handleDownloadStatus);
  };
}, [volume]);
// ...
const handleGlobalShortcut = (e, hotkey) => {
  switch (hotkey) {
    case "nextTrack":
      handleNext();
      break;
    case "prevTrack":
      handlePrev();
      break;
    case "volumeUp":
      const volumeUp = volume > 0.95 ? 1 : volume + 0.05;
      handleVolume(volumeUp * 100);
      break;
    case "volumeDown":
      const volumeDown = volume < 0.05 ? 0 : volume - 0.05;
      handleVolume(volumeDown * 100);
      break;
    case "changePlayState":
      handlePlayPause();
      break;
    default:
      break;
  }
};
// ...
複製程式碼

為了減少渲染次數,我會設定了第二引數為 [volume],但這會導致一些出乎意料的情況,比如我觸發了changePlayState,但卻並沒有得到意料中的值,這個時候設定為 [volume, playState] 就正常了。

原因很簡單,因為playState不在依賴中,不會觸發重新渲染

所以這條經驗就是在使用 hook 遇到問題時,可以先試一下新增到`useEffect·中(如果有用到這個 hook 的話)

元件複用

先來看一下預覽:

基於 Electron + React 的超高顏值喜馬拉雅客戶端 - Mob 誕生記

可以發現很多元件是相似的,如何提高他們的複用,這一個提高開發效率的途徑。

在這個專案中我沒有使用高階元件,而是通過反正控制或者說是render props來進行復用,在元件的指定生命週期中進行呼叫。

共有三個元件在其他多個元件和頁面中複用:

  • 頁面內容載入元件
  • 專輯封面元件
  • 專輯列表元件

頁面內容載入元件如下:

export interface Content<T, R> {
  render: (result: Result) => React.ReactNode;
  genRequestList: (params?: R[]) => Array<Promise<T>>;
  rspHandler: (rspArr: any, lastResult?: any) => Result;
  params?: R[];
}

export default function({
  params, // api 的請求引數
  genRequestList, // 負責返回 api 請求列表,返回值會被`Content`呼叫請求資料,返回值給`rspHandler`
  rspHandler, // 處理請求返回的`Response`值,返回值給`render`
  render //  負責渲染結果,將值傳遞給`render`函式中的元件
}: Content<any, any>) {
  const [loading, setLoading] = useState(true);
  const [hasError, setError] = useState(false);
  const [result, setResult] = useState(null);
  useEffect(() => {
    (async () => {
      try {
        setLoading(true);
        setError(false);
        const rspArr = await Promise.all(genRequestList(params));
        setResult(rspHandler(rspArr, result));
      } catch (e) {
        setError(true);
      } finally {
        setLoading(false);
      }
    })();
  }, [params]);
  return (
    <div className={styles.contentWrap}>
      {loading && !result ? (
        <div className={styles.loading}>
          <Loading />
        </div>
      ) : hasError ? (
        <Empty image={Empty.PRESENTED_IMAGE_SIMPLE} />
      ) : (
        render(result)
      )}
    </div>
  );
}
複製程式碼

利用快取提高體驗度

對 axios 的 get 請求進行封裝,對每個請求 url 生成唯一值,如果在白名單內,存入 session storage 中,預設過期時間是 3600s,在下次訪問時,直接返回該值。

這樣做的一個問題是無法獲得最新資料,但對比體驗感來說並不那麼嚴重。

const request = ({ whitelist = [], expiry = DEFAULT_EXPIRY }) => ({
  ...instance,
  get: async (url: string, config?: AxiosRequestConfig) => {
    if (config) {
      config.url = url;
    }
    const fingerprint = JSON.stringify(config || url);
    // 判斷是否需要快取
    const isNeedCache = !whitelist.length || whitelist.includes(url);
    // 生成唯一值
    const hashKey = hash
      .sha256()
      .update(fingerprint)
      .digest("hex");

    if (expiry !== 0) {
      const cached = sessionStorage.getItem(hashKey);
      const lastCachedTS: number = +sessionStorage.getItem(`${hashKey}:TS`);
      if (cached !== null && lastCachedTS !== null) {
        const age = (Date.now() - lastCachedTS) / 1000;
        // 如果沒有過期,就直接返回該值
        if (age < expiry) {
          return JSON.parse(cached);
        }
        // 否則清除之前的舊值
        sessionStorage.removeItem(hashKey);
        sessionStorage.removeItem(`${hashKey}:TS`);
      }
    }

    const rsp = await instance.get(url, config);

    if (isNeedCache) {
      cacheRsp(rsp, hashKey);
    }
    return rsp;
  }
});

export default request({ whitelist: [] });
複製程式碼

Flex justify-content: space-between 最後一行問題

在 flex 中設定justify-content: space-between後,在最後一行會出現讓人不愉悅的情況。

對於這個問題,我的辦法是通過計算然後填充空的div進去。

const DEFAULT_WIDTH = 130;
const DEFAULT_PAGE_COUNT = 130;
const DEFAULT_WINDOW_WIDTH = 1040;
export default function({
  siderWidth = SIDE_BAR_WIDTH,
  pageCount = DEFAULT_PAGE_COUNT,
  divWidth = DEFAULT_WIDTH
}) {
  const [fillCount, setFillCount] = useState(0);
  const handleResize = debounce(e => {
    let innerWidth: number;
    if (e) {
      innerWidth = e.target.innerWidth;
    }
    // 當前容器的寬度
    const containerWidth = innerWidth || DEFAULT_WINDOW_WIDTH - siderWidth;
    // 每一行可以放的個數
    const rowDivCount = Math.floor(containerWidth / divWidth);
    // 需要填充的個數
    const count = rowDivCount - (pageCount % rowDivCount);
    setFillCount(count);
  }, 100);

  useEffect(() => {
    handleResize();
    window.addEventListener("resize", handleResize);
    return () => {
      window.removeEventListener("resize", handleResize);
    };
  }, []);
  return (
    <>
      {fillCount
        ? // 按照填充個數填進去
          Array.from({ length: fillCount }).map((_, idx) => {
            return (
              <div
                key={idx}
                style={{ width: divWidth, height: 0 }}
                className={styles.filler}
              />
            );
          })
        : null}
    </>
  );
}
複製程式碼

路由的前進與後退

umi或者說是react-router中,也只有memory-router可以判斷是否可以前進或者後退。

只能自己記錄一下 index,然後進行判斷。

let lastHistoryLen = 0;
const NavBar = ({ history, isLogin }) => {
  const { length, action } = history;

  const [curIndx, setCurIndx] = useState(0);
  const [suggests, setSuggests] = useState(null);
  const [text, setText] = useState('');
  const [visible, setVisible] = useState(false);

  useEffect(() => {
   // 判斷最後歷史記錄的長度是否大於當前歷史記錄長度,如果是的話,把 index 歸零
    if (lastHistoryLen > length) {
      setCurIndx(0);
    }
    lastHistoryLen = length;
  });

  const fetchSuggests = debounce(async (kw) => {
    if (!kw) {
      setSuggests(null);
      return;
    }
    const {
      data: { result },
    }: { data: SuggestRspData } = await getSuggest({ kw });
    let suggests = [...result.albumResultList, ...result.queryResultList];
    if (suggests.length < 1) {
      suggests = null;
    }
    // todo (only support albumResult now)
    setSuggests(suggests);
  }, 200);

// ...

  const handleArrowClick = (n) => {
    return () => {
      setCurIndx(curIndx + n);
      router.go(n);
    };
  };

複製程式碼

如何登入

本來想著分析一下登入介面,但是這麼做的話,如果還要加上掃碼登入,要花不少時間。

於是乎想到了使用 webview 嵌入登入頁面,在登入後,如果開啟了個人頁面就說明登入成功了。

const TARGET_URL = "www.ximalaya.com/passport/sync_set";
const COOKIE_URL = "https://www.ximalaya.com";
const WebView = ({ onLoadedSession }) => {
  const [isLoading, setLoading] = useState(true);
  useEffect(() => {
    const webview = document.querySelector("#xmlyWebView") as HTMLElement;
    const handleDOMReady = e => {
      if (webview.getURL().includes(TARGET_URL)) {
        // todo fix prevent redirect
        e.preventDefault();
        const { session } = webview.getWebContents();
        onLoadedSession(session, COOKIE_URL);
        webview.reload();
      }
    };
    const handleLoadCommit = () => {
      setLoading(true);
    };
    const handleDidFinishLoad = () => {
      setLoading(false);
    };
    webview.addEventListener("dom-ready", handleDOMReady);
    webview.addEventListener("load-commit", handleLoadCommit);
    webview.addEventListener("did-finish-load", handleDidFinishLoad);
    return () => {
      webview.removeEventListener("dom-ready", handleDOMReady);
      webview.removeEventListener("load-commit", handleLoadCommit);
      webview.removeEventListener("did-finish-load", handleDidFinishLoad);
    };
  }, []);

  const props = {
    id: "xmlyWebView",
    useragent:
      // tslint:disable-next-line:max-line-length
      "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_13_5) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/73.0.3683.103 Safari/537.36",
    src: `https://${TARGET_URL}`,
    style: { widht: "750px", height: "600px" }
  };
  return (
    <div>
      <Spin tip="Loading..." spinning={isLoading}>
        <webview {...props} />
      </Spin>
    </div>
  );
};
複製程式碼

最後

希望這篇文章能對你有所幫助。

下載與體驗

相關文章