1
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

Claude Codeですぐに作れると思ったけどメモリとストレージの管理でめちゃくちゃ指示が必要だったメールアプリ開発

1
Posted at

はじめに

メールを「件名の一覧」ではなく「やり取りしている相手ごと」にチャットのように並べる iPhone アプリ「チャットdeメール」を作り、App Store で公開しました。

コーディングは全部 Claude Code です。僕は要件だけひたすら伝え続けました。

最初は正直、すぐできると思っていました。
実際、メールの受信・解析・相手ごとのまとめ・画面・送信までの最初の版は、初日のうちに iPhone で動きました。

しかし、そこから先が長かったです。

開発期間中のclaude codeへの指示のうち、8割が読み込み時間とストレージの最適化だったように思います。
この記事では、そのとき起きた課題と、僕が Claude Code に出した指示とそれに対するclaude codeの対応を時系列で並べます。

こだわりの前提: サーバーを持たないメールアプリ

安心して使ってもらうために、自前のサーバーは用意しないことにしました。
iPhone から Gmail・Yahoo!メール・iCloud などのメールサーバーに IMAP で直接つなぎます。

  • メールもパスワードも、開発者のサーバーを通らない(開発者にもメールが見えない)
  • Gmail API を使わないので、Google の審査やセキュリティ監査(CASA)がいらない
  • そのかわり、サーバー側で事前に整理しておく、ということができない

構成は、React Native(Expo)の画面と、画面に依存しない TypeScript のメールエンジン(IMAP/SMTP・MIME 解析・会話へのまとめ・SQLite への保存)のモノレポです。


1. 過去のメール一覧を取得したけど...(初日)

課題

最初の版が iPhone で動いた直後に、根本的な問題に気づきました。

できた!いいね
でもよく考えたら、昔のメールまで取ってきて相手ごとに整形するのは無理があるよな。でも昔のメールも見れる必要があるんだよな。
やっぱサーバー立てて非同期で過去のメールをクロール&整形しつつアプリ側で最低限のデータを取得するしか無いのかな

Claude Code の提案

自前のサーバーを立てる案に対して、Claude Code は「昔のメールを見るためだけなら、サーバーはいらない」と返してきました。

そして、「一覧画面では見出しの情報だけ取れば軽くなるよ」と提案してくれました。

- 相手ごとにまとめるのに必要なのは、差出人・宛先・日付・件名といった**見出しだけ**。1通 1KB ほどなので、1万通でも 10MB 程度
- 見出しを新しい順に少しずつ取り、本文は会話を開いたときに取る
- まだ取り込んでいない昔の分は、その場でメールサーバーに検索してもらう(IMAP の `SEARCH`。Gmail なら `X-GM-RAW` で Gmail の検索と同じ書き方が使える)

それでいいに決まっているので、本文全取得をやめて一覧画面に必要な情報だけ取得することにします。

チャット画面に進んでからその相手からのメールの本文を全部取得することにしました。

指示

うん、じゃあそれでいこう
その上で、ある相手を選んでそのチャットルームに入ったら、先にその場でその相手から来た過去のメールを全て取得するようにしたい。その方が自然でしょ?

すぐに作ってくれたのですが、その相手からのメールが多すぎると動作が重すぎることに気づきました。

何千通も来ている送り主の会話を開いた場合を想定して、一定数だけ読み込んでさらにページを引っ張ったら追加で読み込む、というのを繰り返す仕様だといいかな?

結果

会話を開くと、その相手との過去のメールを新しい順に50通取り、いちばん上で引っ張ると次の50通を取る形になりました。

会話の画面

ここで学んだこと: 「全部取る」と言うと、AI は本当に全部取りに行きます。件数の上限やページングは、こちらで考えて指示が必要でした。


2. 無限スクロールって、難しいんだな(2〜4日目)

課題

自分の実際のメールボックス(1万数千通)を入れると、一覧のメールを全部メモリに読み込んでいてアプリが重すぎて止まりました。

これじゃ使いものにならない

メールの数だけスマホのストレージやメモリを無限に食うようじゃダメです。

何十万通あっても軽く動くこと、そして昔のメールにもどこまでもさかのぼれることの両方を条件にして、作り直してもらいました。

Twitter(X)みたいに、理論上無限スクロールが可能にしてほしい。
つまり、スクロールしながら読み込むメールの範囲をスライドさせて、ストレージが一定以上は消費しないようにしてほしい。

と伝えました。

対応

ここは大きく作り直しになりました。

スクロールに合わせて、メモリに保持するメールの範囲も一緒にスライドしていく作りにしました。
メモリにあるのは、いつも画面に映っているメールの前後だけです。画面から離れた分はメモリから外し、戻ってきたらまた読み込みます。

SNS のタイムラインと同じで、「メモリと容量に上限を持ったまま、どこまでもさかのぼれる」作りです。

相手ごとの一覧

3. 写真が重すぎる(10日目〜)

画像を含んだメールを開こうとすると、読み込み時間がめちゃくちゃ長いことに気づきました。

課題

そもそも画像ファイル入れただけでそんな時間かかってしまうものなの?
gmailアプリなら一瞬だったよ?

他アプリと比べて短所を批判するなんて心が痛みますね。

状況としては、選んだ写真をそのまま添付していました。
メールは添付を base64 にするので、実際には約11MB送っていたのです。

対応と、その後の指示

写真を JPEG にして長い辺を2000pxに縮め(8MB → 1MB前後)、送信は非同期で行う「送信トレイ」を作りました。

とはいえ画質を落としたくない場合もあるでしょうから、選択式にします。

あと、地味に大事だと思ったのはプログレスバーです。
「現在何%」って出るあれです。
あれは、上手く使えばユーザーのストレスを軽減するすることができます!

よく考えたら、勝手に圧縮させて画像ファイルの画質を落とすのはよくないかもね
圧縮するかどうか選ばせるようにする?
あと、送信に時間がかかることを想定してプログレスバーを表示しないかい?

1MB を超える写真では「小さくして送る(おすすめ)」「元の大きさで送る」を大きさつきで聞き、本文を64KBずつ書いて「送信中 45%」とバーで出すようにしました。

まだ問題はあります。

大きな画像を選択した時、送信ボタンを押しても反応が遅くて、何回も押してみて、5秒以上たってから送信中の表示になった。

押した瞬間に「送信中」を描いてからメールを組み立てるように変え、base64 を文字列の連結ではなくバイト列で作るようにして、組み立て自体も速くしました。


4. 同じメールを開くたびにダウンロードしている(13日目)

課題と指示

大きいメール(1MB超)は、端末には見出しだけ置き、本文は開いたときにサーバーから取る作りにしていました。

同じメールでも詳細を開くたびに本文を全てサーバーから読み込むのはちょっと大変かも。
前回開いたメールくらいは端末でキャッシュとして持っておこうか

対応

  • 最近開いた大きいメールは、全文を端末の一時フォルダーに置く。「前回の1通」だと2通を行き来したときにまた読み込むので、3通まで

さらにもう一つ。

タップしてから開くのが遅い。すぐに開けないなら「読み込み中」とか出していい。とにかく、何かを押したら何かしらの反応がすぐに返ってくるようにして

重い画面は先に「読み込み中…」を描いてから処理するようにしました。この指示は、以後のルールとして Claude Code の記憶にも残してもらっています。


5. 4Gだと11MBのメールに2分以上かかる(14日目)

ある程度快適に使えるようになったと思ったある日、外出先で開くと
めちゃくちゃ画面開くの遅い…

課題

今、WiFiが無い外でメール本文を読み込んだけど、めっちゃ時間かかるな。11MBで2分以上かかった。
電波はバリ4。もちろんgmailアプリならすぐに読み込んだ。この差って何?やはりメールサーバー直接通信はそんなもん?

「さすがにサーバー必要かな」と思ったのですが、違いました。

原因

外の電波では、データが小さな切れ端で何千回にも分かれて届きます。受け取る部分が、切れ端が1つ届くたびに、それまでに届いた分を全部つなぎ直していました。

// 直す前(IMAP の応答を組み立てる部分)
push(chunk: Uint8Array): Uint8Array[] {
  // 届くたびに「これまでの全部 + 新しい切れ端」を新しく作り直す
  this.buf = this.buf.length ? concatBytes([this.buf, chunk]) : chunk.slice();
  // ...

10MB 届いたあとに 1KB の切れ端が来ると、10MB+1KB を丸ごとコピーし直します。
それを切れ端の数だけ繰り返すので、計算量は二乗です。家の WiFi では1回に届く量が大きいので目立っていませんでした。

対応

IMAP では、メール本体の前に {11534336} のように「この後に何バイト続くか」が書いてあります。それを目印に、切れ端はリストに積んでおき、そろったら1回だけつなぐようにしました。

// 直した後
push(chunk: Uint8Array): Uint8Array[] {
  if (this.need) {
    // メール本体の途中なら、切れ端はリストに並べておくだけ
    this.waiting.push(chunk.slice());
    this.waitingBytes += chunk.length;
    if (this.buf.length + this.waitingBytes < this.need) return []; // まだそろっていない
    // そろったら、一度だけつなぐ
    this.buf = concatBytes([this.buf, ...this.waiting]);
    // ...

Mac で 11MB を外の電波くらいの小さな切れ端で受け取る実験をしたところ、つなぐ時間は約2.3秒 → 0.006秒になりました。
iPhone(Hermes)は Mac より遅いので、実機ではこの差がもっと大きく出ていたはずです。変更は40行ほどでした。


6. キャッシュしたはずなのに「読み込み中」が出る(14日目)

課題

あれ、直近何個かのメールを端末に保存する仕様は無くなったの?同じメール開き直すと読み込みしてそうだよ

Claude Code からは「サーバーから取り直しているなら%付きのバー、端末から読んでいるなら『読み込み中…』が一瞬出るはず。どちらでしたか」と聞き返されました。

読み込み中が5秒くらい出ただけでした

原因と対応

サーバーには行っていませんでした。ただ、開き直すたびに、端末に置いた 11MB のメール全体を読み出して、そのたびに解析し直していたのが5秒の正体でした。

  • 一度開いたメールは、添付ファイルを除いた本文を SQLite に入れる。2回目からは解析なしで出す
  • 本文に写真が埋め込まれたメールは、base64 を一度デコードして作り直すのをやめ、元の base64 をそのまま data: URL に使う(0.85秒 → 0.2秒)

ここで学んだこと: 「キャッシュして」と言えばキャッシュは作られます。でもキャッシュから出すのが速いかどうかは別の話で、触ってみないと分かりませんでした。


7. 「無限にストレージを食う設計にはなってないね?」(14日目)

キャッシュを足し続けたので、念のため聞きました。

無限にストレージを食う設計にはなってないね?

返ってきた答えがこれです。

保存するもの 上限 超えたとき
メールの本文 合計300MB 長く開いていないメールから本文を捨てる。見出しは残るので、開けばサーバーから取り直す
メールの見出し 10万通 新しい2万通は必ず残し、それより古くて長く開いていないものから消す
大きいメールの全文(添付込み) 3通 古いものから消す
開いた添付ファイル 7日 7日たったら消す
送信トレイ 送れたら消す 送れなかったものは画面に出して残す

加えて、本文に大きい写真が埋め込まれたメール(本文が約100万文字を超えるもの)は、300MB の枠を埋めないようにデータベースに入れない、という線引きもしてくれていました。


8. アプリを開いて最新のメールが出るまで20秒(15日目)

課題

やっぱりまだ少し外出先での処理の遅さが気になりました。

最初の一覧画面で最初に読み込むメールは、何件?今日、外出時に4G回線環境でアプリを開くと、最新のメールを読み込むのに時間がかかった。20秒くらいはかかったから閉じて、Gmailアプリを開いたら最新のメールがすぐに取れた

claudeには常にgmailアプリをライバルだと思って欲しいんです。

原因

前回から後に届いたメールを、古い順に、本文ごと全部取り終えるまで、一覧に1通も出していませんでした。一晩でメルマガなど数十通届いていると、それを全部 4G で取り終わるまで、一番新しいメールが出てきません。

対応

見出しと本文を分けて、どちらも新しい順に取るようにしました。

// 1. 見出し(差出人・件名など)だけを先に取って保存する。軽いので、電波が遅くてもすぐ一覧に出せる
//    (uids は新しい順に並べてある)
for (let i = 0; i < uids.length; i += HEADER_BATCH) {
  const batch = uids.slice(i, i + HEADER_BATCH);
  const { messages } = await fetchMessages(client, mailbox, uidValidity, batch, 0); // 0 = 本文は取らない
  await store.saveMessages(messages);
  for (const m of messages) if ((m.size ?? Infinity) <= maxFullSize) smallUids.push(m.uid);
  await options.onSaved?.(); // 一覧を作り直す(画面側で3秒に1回まで)
}

// 2. 小さいメールの本文を、新しい順に取る
smallUids.sort((a, b) => b - a); // サーバーは古い順に返すので並べ直す
for (let i = 0; i < smallUids.length; i += batchSize) {
  const batch = smallUids.slice(i, i + batchSize);
  const { messages } = await fetchMessages(client, mailbox, uidValidity, batch, maxFullSize);
  await store.saveMessages(messages);
  await options.onSaved?.();
}

本文がまだ届いていないメールは、一覧に本文の出だしの代わりに件名を出します。途中で電波が切れても見出しは残ります。

Gmail アプリは Google のサーバーが新着を先に iPhone へ送っておく仕組みなので、開いた時点ですでに手元にあることが多いです。
サーバーのないこのアプリは開いてから取りに行くので1回の通信はどうしてもかかりますが、見出しを先に出すことで、開いてすぐ新しいメールが並ぶようになりました。


振り返り

Claude Code に任せて速かったこと

  • IMAP・MIME・日本語の文字コード(ISO-2022-JP など)・SMTP といった「仕様が決まっているもの」の実装
  • 設計の相談。「サーバーを立てるしかないのか」と聞いたら、立てない方法と理由を出してくれた
  • 原因の説明。コードを見せてもらいながら説明してもらえるので、自分でも理解できた

人間がやらないといけなかったこと

振り返ると、出した指示のほとんどは実機で使って気づいたことでした。

  • 外で、4Gで使う。 WiFi では一度も問題が出なかった
  • 自分の本物のメールで使う。 サンプルのメールでは、件数も大きさも足りなかった
  • 身近な比較対象と比べる。 「Gmailアプリなら一瞬だったよ?」が、ほぼすべての改善のきっかけになった
  • 件数・上限・体験を言葉にする。 「全部取って」ではなく「一定数ずつ」、「速くして」ではなく「押したら何かしらの反応がすぐに」
  • ときどき確認の質問をする。 「無限にストレージを食う設計にはなってないね?」

チャットdeメール

メールを相手ごとにチャットのように並べる iPhone アプリです。Gmail・Yahoo!メール・iCloud などに対応していて、開発者のサーバーを通らないので、開発者にもあなたのメールは見えません。。

紹介サイト: https://haruki-lo-shelon.github.io/chatdemail/

1
0
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
1
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?