1人でデスクトップとモバイル両方で動いて同期するアプリをどうやって作ったか

Share
1人でデスクトップとモバイル両方で動いて同期するアプリをどうやって作ったか

1人でデスクトップとモバイル両対応でデータ同期するアプリをどうやって作ったか

5プラットフォームで動くSaaSを個人で開発するためにやったこと

こんにちは、個人アプリ作家のTAKUYAです。InkdropというクロスプラットフォームなMarkdownノートアプリを1人で開発しています。このアプリはmacOS、Linux、Windows、Android、iOSで動作します。ご存知かもしれませんが、この5プラットフォームにアプリを対応させるのは簡単ではありません。しかしながらパワフルなフレームワークを活用すれば、それも不可能ではありません。それらに頼るだけでなく、プロジェクトを持続可能に保つための開発戦略も必要となります。本記事では、僕がこれまでどのようにして開発して来たのかシェアしたいと思います。

あなたは1人で開発しているのではない

クロスプラットフォームなアプリの開発は、往々にして多くの予測不能かつ再現不能な問題を伴います。自分の環境では正しく動いていた機能が、他の環境では思うように動かない。例えば、最近僕もそういう問題を経験しましたが、それは起動直後にアプリの画面が空白になるというものでした。僕は事前に入念にベータ配信を重ねてテストをしていましたが、それでもこの問題は見つけられませんでした。しかし、ユーザさんの素早い報告とやりとりのおかげで、24時間以内に解決する事が出来ました。

個人開発者は、実際には1人で開発しているのではありません。なぜなら、いつでもこのようにユーザに助けを求めることが出来るからです。正直に誠実に、今何を取り組んでいて何に困っているのか述べましょう。あなたのアプリを楽しんでいるユーザは、基本的にあなたのアプリの成功を願っていますし、喜んで助けようとしてくれます。ユーザの助けに頼ることはとても重要です。あなたのリソースはとても限られているからです。Inkdropもユーザの皆さんの協力がなければ、ここまでの完成度には到底辿り着けませんでした。Inkdropはプログラマ向けなので、このフォーラムでのケースのように、ユーザ側から問題を解決するためのコード例まで示してくれることもあります。その上、僕の手元で再現できないバグを修正するために、数時間も付き合って下さることもしばしばあります。このようなユーザとの緊密で双方向なコミュニケーションは、大企業に対抗できる大きな優位性でしょう。

Inkdropのユーザフォーラム

CouchDB & PouchDB: シームレスなデータ同期とオフライン対応

Apache CouchDBドキュメント指向データベース(NoSQL)で、HTTPベースのJSON APIを備えていて、かつマルチマスタで同期出来ます。FauxtonというウェブGUIがあり、データベースやドキュメントを簡単に管理できます。PouchDBはこのCouchDBにインスパイアされたJavaScript製のデータベースで、同様にCouchDBと同期出来ます。まず僕はデスクトップ版に取り掛かり、モバイル版は特に気にかけませんでした。というのも、PouchDBはJavaScript製で既にいくつかの選択肢が用意されていたので、大丈夫だろうと想定していました。もしうまく動かなければ、自分でモジュールを組めばいいと考えていました。CouchDBのAPIがRESTfulでシンプルだからです。

なぜ僕が他のfirebaseなどのPaaS (Platform-as-a-Service)ではなくCouchDBを選んだかというと、クライアント側での柔軟なインデクシングを必要としていたからです。3年前、僕がこのプロジェクトを始めた当時、firestoreは要件を満たすほど柔軟ではありませんでした。PouchDBはクライアントでのMapReduceに対応しており、全文検索用のモジュールもあったので有望だと判断しました。更に、CloudantというCouchDB用のDBaaSがあったのも決め手になりました。Cloudantはスループットやストレージサイズを柔軟に変えられます。サーバ運用は出来るだけ避けたかったので、最初の頃はこれを採用しました。現在はAWS EC2上でCouchDBを運用しています。理由は、BtoCサービスほど負荷が不安定だったり大きくないという事が分かったのと、Cloudantは重くて、IBM Cloud上での管理が煩雑さったためです。

今のところ、CouchDBとPouchDBの組み合わせは総じて満足しています。

クロスプラットフォームなフレームワーク

5プラットフォームで動かすために、デスクトップOS (Windows/Linux/macOS)ではElectronを、モバイルOS (iOS/Android)ではReact Nativeを採用しました。双方のバージョンでReactJSとReduxを使用しています。これらのフレームワークのおかげで、基本的にロジックは全部JavaScriptで組めましたし、デスクトップとモバイル間で多くのコードベースを共通化させる事が出来ました。

成功しているプロダクトから学ぶ

Kitematicの美しいUI

当時、ElectronとReactJSでアプリを組むのは初めてで知見がありませんでした。でも出来るだけ早くアプリを世に出してアイデアを検証したいと考えていました。そこで、美しいUIや拡張可能なアーキテクチャを組むための現時点でのベストプラクティスを手っ取り早く学ぶために、既存のオープンソースプロジェクトであるAtom EditorKitematicに着目しました。これらのプロジェクトはGPLライセンスではなかったので、コードベースを自分のアプリに再利用出来る事を知りました。ありがとう、GitHubとDocker。

Kitematicのリポジトリをフォークする所から始めました。この方法は多くの良い実践を学べて、多くの問題を事前に回避できましたが、1つだけ欠点がありました — それは、技術的負債も一緒について来るという事です。技術的負債は多くのプロジェクトに大体あるものなのでしょうがないです。例えば、Kitematicはfluxアーキテクチャの実装としてAltJSを採用していました。しかしAltJSは僕がInkdropに着手した後、程なくして更新が止まってしまいました。それによって、Reactを最新版の16にアップグレードできずにいました。最終的にはAltJSをReduxと完全に置き換える事で対処しました。しかしながら、こういう事態は予期できないものです。Kitematic自身にとっても予想外だったでしょう。こういったプロジェクトから学べることは沢山あります。なので、僕がもしまた似たような状況になったら、進んで同じアプローチを取るでしょう。

また、Atomのコードを沢山お借りして、プラグイン機構、キーマップのカスタマイズ機能、テーマ機能などを実装しました。彼らのコードは読む度に発見があり驚きに満ちていました。これらを1人でイチから実装するなんて事は、到底できなかったでしょう。

コードベースを共通化する

デスクトップとモバイル版は両方共PouchDB、ReactとReduxで組んであるので、データモデルやRedux Action, Reducerなどプラットフォームに依存しない多くの部分を共通化出来ました。そのお陰で、両方を同時に効率よくメンテできるようになりました。

UIコンポーネント群はプラットフォームごとに組む

UIはデスクトップとモバイル版で分けて組みました。そもそも、まず最初にデスクトップ版から開発していましたし、自分が将来モバイル版をどうやって組むのかすら考えていませんでした。これは個人的な意見ですが、UIコンポーネント群をデスクトップとモバイル版で共有するのはあまり良い戦略ではありません(とりわけInkdropでは)。なぜなら、react-native-webのようなライブラリは基本的にモバイルファーストで、デスクトップにはフォーカスしていません。なので、もしアプリのUIがとてもシンプルで、主なターゲットがモバイルユーザである場合に限り有効な戦略だと思います。

デスクトップ版はSemantic UI、モバイル版はNative Baseを使って美しいUIとテーマ対応を実現しました。React Nativeに関する開発の知見はこちらの記事に書きました:

React Native製アプリのクオリティを上げるために工夫した事
InkdropというMarkdownノートアプリを一人で作っているTAKUYAです。最近、React Nativeを使って、iOS版とAndroid版の新しいバージョンをリリースしました。React…

PouchDBをReact Nativeで動かすための四苦八苦

PouchDBはブラウザやElectron製アプリでは問題なく動作します。しかしReact Nativeとなるといくつか問題があります — pouchdb-react-nativeを使うと、AsyncStorageをアダプタにして動作するのでパフォーマンスが良くありませんでした。そこでreact-native-sqlite-2pouchdb-adapter-react-native-sqliteを作って、SQLiteをアダプタとして動作するようにしました。もう1つの問題は、attachmentsを上手く取り扱えないことです。これに関しては、PouchDBのコアモジュールを改造して対処しました:

PouchDBを改造してReact Nativeでも動くようにした - Qiita
gt; 本稿は[Hacking PouchDB to Use It on React Native](https://dev.to/craftzdog/hacking-pouchdb-to-use-on-react-native-1...

SQLite3を使ったローカル全文検索

初期の頃はpouchdb-quick-searchを使ってローカルでの全文検索を実装していましたが、特にAndroidでパフォーマンスが良くありませんでした。なのでpouchdb-quick-searchの実装を参考にして、SQLiteの全文検索機能を使ったFTSモジュールを自分で組みました。

Read more

個人開発と生活

個人開発と生活

朝、娘をバス停まで送り出す。前にちらっとみかけた田村淳の相槌術が面白そうだったので、ママ友との雑談で早速実践してみたら効果てきめんだった。その方法は単純に、職業病で癖になっている批判的思考を完全オフにし、相槌に全神経を注ぐ、というものだ。「へぇ」「うん」「うーん」「なるほど〜」と、相手の話にどんなバリエーションで返そうかという所に集中する。騙されたと思って試してみて欲しいんだが、このお陰で相手の話がよく理解できて、自然なフォローアップの質問やリアクションが浮かぶようになる。こちらから頑張って面白い話をひねり出す必要が無いので、気が楽になった。話の結論も何もいらなくて、「そうなんですね」「いいですね」「ほんじゃお疲れ様です〜」みたいな感じで締めくくる。反応に困ったらとりあえず「いいですね」まじで便利!男相手の会話でも有効。インタビューにも応用が利きそうだ。 天気が悪くてだるいので、やる気が出るまで部屋でレシートの撮影などの単純作業をして過ごした。レシートを撮ったら事務代行さんに投げる。そのうちAIに代替させたい。レシートは基本カフェばっかりである。 ユーザフォーラムをチェックしたら、

By Takuya Matsuyama
個人開発で日本から海外へ、10年間の歴史 — ひろしさんとの対談(前編)

個人開発で日本から海外へ、10年間の歴史 — ひろしさんとの対談(前編)

数週間前、ひろしさんのポッドキャストにゲストで出演しました。お互いの長い個人開発の経験について語り合いました。英語版を作成する過程で、日本語でも綺麗に整形した書き起こしが出来たので、こちらに掲載します。お楽しみください。 ※ギアアイコンをクリックして、音声と字幕を日本語に変更できます。 00:00 イントロ:TAKUYAさんようこそ 01:32 TAKUYAさんの自己紹介:WalknoteからInkdropまで 04:54 独立への踏み切り方:慎重派と勢い派 06:51 個人開発がフリーランス案件につながった 09:17 Inkdropで食えるようになるまで 12:15 なぜ最初から海外市場を狙ったのか 14:54 AI登場前、英語コピーに苦戦した話 16:18 AIバイブコーディング時代をどう見ているか 17:24 全てのコードを一行ずつレビューする使い方 21:06 AIは新幹線:速さの先にあるもの 25:53 AI時代に「感性」が大事になる 27:

By Takuya Matsuyama
「一汁一菜」にAI時代の生き方が詰まっている

「一汁一菜」にAI時代の生き方が詰まっている

どうも個人アプリ作家のTAKUYAです。 今回は、AI時代を開発者・クリエイター・表現者としてどう健やかに生きるか、について考えていることをシェアしたいと思います。ここでの「健やかに生きる」とは、心身の健康を保ちながら、ものづくりを楽しみ続けるという意味です。 読者の中にも、最近のAIの急速な進化の中でどう生き残り、さらに活躍していくかを悩んでいる方は多いのではないでしょうか。正直、すべてに対する正解はわかりません。未来を正確に予測できる人はいないからです。 でも自分は、ソフトウェア寄りのアーティストとして生きる上で大事なのは、「戦略」や「堀(moat)」を築くことよりも、「生きる方向性」 だと思っています。 人生とは速度ではなく方向である – ゲーテ 自分はどこに行きたいのか?何を見たいのか?それが大事です。戦略は状況に合わせて柔軟に変えればいいからです。 今回は、日本の文化からいくつかの生き方の原則を探ってみたいと思います。 最近、料理研究家の 土井善晴 さんの 「一汁一菜でよいという提案」 を読んで、日々のリズムを健やかに保つためのヒントがたくさん詰まっていると感じまし

By Takuya Matsuyama
Claude Codeをtmuxのポップアップウィンドウで継続的に走らせる方法

Claude Codeをtmuxのポップアップウィンドウで継続的に走らせる方法

💡本記事は英語ブログの日本語訳です。 どうも、TAKUYAです。 AIコーディングでは専らClaude Codeを使っています。最初はtmuxでターミナルの右側にペインを分割して使っていたのですが、幅が狭すぎてメッセージやdiffがまともに表示できず、使いづらかったです。 <Prefix>+zでペインを最大化すればいいのですが、毎回やるのは面倒でした。 そこで、ポップアップウィンドウでClaude Codeを起動するようにしました。キーバインドを押せばセッションが開き、閉じてもバックグラウンドで動き続けるので、すぐに再開できます。 この記事では、それを実現するためのtmuxの設定方法を紹介します。 動画で見る(英語): ポップアップウィンドウはサブプロセスを維持できない tmuxのdisplay-popupコマンドを使うとポップアップウィンドウを表示でき、ちょっとしたツールにすぐアクセスするのに便利です。 僕はlazygitでgitの状態をサッと確認するのに使っています: bind -r g display-popup -d '#{pane_current_path}'

By Takuya Matsuyama