Hacktoberfest 2026:メンテナが10月に向けて印を付けた、オープンで初心者向けの issue。 Hacktoberfest の issue を見る

Android: emulators start without gRPC, so tools that need the emulator gRPC endpoint (Argent) cannot drive leased devices

オープン 初心者向け
#639 コメント 0 件 リアクション 0 件 担当者 0 名 GitHub で見る

メンテナーはふだん 1 日以内に返信

まだ誰も着手していません。

評価

難易度
2/5
見積もり時間
1〜3時間
初心者へのやさしさ
70/100
issue の種類
バグ
明瞭さ
明確に書かれている
活発さ
活発
技術スタック
android, grpc

調査の方向性

エミュレータの起動引数は emulatorLaunchFlags の近くで組み立てられています。Issue によると、ユーザーが指定した生のフラグを受け付けるべきではありません。まずそこから始め、コンソールポートがどのように選ばれているかを確認してください。そうすることで、管理下の他のポートと衝突せずに gRPC ポートを port + 3000 として導出できます。完了の条件は、リースされたエミュレータが gRPC ポートで待ち受け、grpc.token を含む pid_*.ini を書き出し、Argent のスクリーンショットと gesture-tap が成功することです。

索引モデルが issue の本文から書いたものです。

説明

This issue was written by Claude (an AI coding agent) while it investigated a tooling problem for me. I reviewed it and approved posting it.

simlock 0.2.0 starts emulators with the args below. main (0.3.0) uses the same args.

emulator -avd <avd> -port <n> -no-snapshot-save [-snapshot simlock_clean_baseline]

When -port is set and -grpc is not, the emulator:

  • starts no gRPC server, and
  • writes no discovery file (~/Library/Caches/TemporaryItems/avd/running/pid_<pid>.ini on macOS).

Without -port, the emulator turns on gRPC by default (console port + 3000, with a token) and writes the file.

Tools that drive the emulator over gRPC read that file. Argent is one. On a leased emulator its screenshot and gesture-tap fail with:

emulator "emulator-5558" not found among running emulators (a token-less `-grpc` launch omits grpc.token; check avd/running/*.ini)

adb-only tools still work, so the device looks healthy. Argent documents the same failure for any emulator launched without -grpc: software-mansion/argent#1192.

Repro (macOS, emulator 36.6.11, simlock 0.2.0)

  1. simlock lease --platform android --device "Pixel 9" --agent-id test --detach
  2. ls ~/Library/Caches/TemporaryItems/avd/running/ → no pid_*.ini for the leased emulator.
  3. lsof -nP -iTCP -sTCP:LISTEN -p <emulator pid> → console and adb ports only, no gRPC port.

Matrix (throwaway AVD, launched by hand)

Flags gRPC endpoint + .ini
-port 5570 -no-snapshot-save no
no -port yes, grpc.port=8556
-port 5570 -grpc 8570 -grpc-use-token yes, and Argent works

Proposed fix

Add -grpc <port + 3000> -grpc-use-token to the emulator launch args.

  • Base the gRPC port on the console port, like the emulator's own default, so parallel leases never collide. With console ports above 5585 on main, it may be worth checking that port + 3000 stays clear of other simlock-managed ports.
  • The token keeps the endpoint authenticated. Argent also requires grpc.token in the .ini.
  • Users cannot work around this: config cannot add raw emulator flags (by design, per the comment near emulatorLaunchFlags).

Optional: expose the gRPC port in the grant, so tools do not have to find it through the discovery file.

主要言語
TypeScript
スター
19
フォーク
1
平均マージ
7時間 49分
マージ済み PR(30日)
228

環境構築

このプロジェクトには開発コンテナ、Dockerfile、コントリビューションガイドがありません。まず README を読み、一般的な手順ははじめてのコントリビューションガイドを参照してください。

はじめの一歩

  1. issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
  2. 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
  3. リポジトリをフォークし、ブランチを切って変更します。
  4. issue 番号を参照したプルリクエストを送ります。

callstackincubator/simlock のほかの issue

callstackincubator/simlock の issue をすべて見る

似ている issue

TypeScript の issue をもっと見る

新しい issue をメールで受け取る

初心者向けの GitHub issue を短くまとめたダイジェスト。