安装与首次启动。Install and start.

安装前准备Before installation

准备一台 Android 6.0 或更高版本的手机，以及可以访问 Google Play 的网络。进入手机“设置 → 关于手机”查看 Android 版本；不同品牌的菜单名称可能略有差异。Prepare a phone running Android 6.0 or later and a network that can access Google Play. Check the Android version in Settings → About phone; menu names vary by manufacturer.

本教程对应手机扫码枪 Android 1.0.0；截图来自 Android 实机。iOS、鸿蒙的安装入口和权限界面不同，请在教程中心选择对应平台。This guide covers Scan Input for Android 1.0.0 and uses screenshots from a real Android phone. iOS and HarmonyOS have different installation and permission screens; select the matching platform in the guide center.

通过 Google Play 安装Install from Google Play

首次启动：协议和教程入口First launch: agreements and guide

第一次扫码：允许相机权限First scan: allow camera access

蓝牙所需的系统权限会在使用蓝牙连接流程时另行提示。完成相机授权后，可以先扫码并查看本地历史，再选择电脑连接方式。Bluetooth-related system permissions are requested separately during Bluetooth setup. After allowing the camera, you can scan and inspect local history before choosing a computer connection.

确认安装和首次设置完成Verify installation and first setup

• 点击中央扫码按钮后出现相机画面，顶部有“返回”和“切换”，底部有“闪光灯”、关闭按钮与“相册识别”。The scanner shows a camera preview, Back and Switch at the top, and Flashlight, a close button, and Scan from gallery at the bottom.
• 扫码成功后，结果出现在扫码页底部，扫码页仍保持打开。点击返回后，可在“历史”页看到内容、类型和时间。After a successful scan, the result appears near the bottom and the scanner stays open. Return to History to see its content, type, and time.
• 打开底部“设置”，查看版本信息和“扫码后缀”“自动恢复上次连接”“震动效果”“声音提示”“网页自动跳转”等选项。Open Settings to check the version and options for scan suffix, automatic connection restoration, vibration, sound, and webpage opening.

安装与权限常见问题Installation and permission questions

Google Play 中找不到或无法安装Google Play cannot find or install the app

通过本页官方 Google Play 链接重新打开，并检查网络、Google Play 可用性和 Android 系统版本。安装入口以该商店页面为准；官网没有 APK 下载按钮。Reopen the official Google Play link on this page and check your network, Google Play access, and Android version. The store listing is the installation source; the website has no APK download button.

相机预览黑屏或仍提示权限The camera preview is black or permission is still required

确认已允许相机权限，关闭其他占用相机的应用，再退出扫码页重新进入。若系统权限已被永久拒绝，请在系统应用设置中修改；更换到前置摄像头后黑屏时，可切回后置摄像头。Check camera access, close other apps using the camera, then leave and reopen the scanner. If permission was permanently denied, change it in system app settings. If the front camera is unavailable, switch back to the rear camera.

接受协议后还能再查看吗？Can I read the documents again after accepting?

可以。进入“设置”，点击“用户协议”“隐私政策”或“使用教程”即可再次查看。Yes. Open Settings and choose User agreement, Privacy policy, or User guide to view them again.

下载安装前，先核对发布入口Check the release entry before installation

iOS 版支持 iPhone 和 iPad，当前工程要求 iOS 17.0 及以上。本教程使用 iOS 模拟器中的开发版本演示界面，模拟器截图不表示已经在 App Store 上线。The iOS app supports iPhone and iPad and the current project requires iOS 17.0 or later. This guide illustrates a development version in the iOS Simulator; the screenshots do not imply an App Store release.

1. 在官网下载区查看 iOS 卡片；当前标为“即将上线”时，请等待官方发布入口，不使用 Android APK 或鸿蒙安装包。Check the iOS card in the website Download section. If it says Coming soon, wait for an official release entry. Android APK and HarmonyOS packages cannot install this app on iOS.
2. 官方提供 App Store 或测试分发入口后，在 iPhone / iPad 打开该入口，核对应用名称与开发者，再按系统提示安装。已获得官方测试版本的用户可以从下一步开始。When an official App Store or test-distribution entry is available, open it on the iPhone/iPad, check the app and developer, and follow the system’s installation steps. Users with an official test version can continue below.
3. 应用本身无需注册账号；如系统商店需要 Apple 账户，按商店自己的提示操作。首次使用可先仅在手机保存记录，连接电脑稍后设置。The app itself requires no account. Follow the store’s own prompts if it requires an Apple account. You can first save local records and set up a computer connection later.

首次启动、协议与主界面First launch, agreement and main screen

1. 打开“手机扫码枪”，在“欢迎使用手机扫码枪”弹窗点“查看用户协议”和“查看隐私政策”阅读正文，返回后决定是否接受。Open Scan Input and use View User Agreement and View Privacy Policy in the welcome alert to read the documents, then decide whether to accept.
2. 接受后点“同意并继续”，下一提示可选“查看使用教程”或“稍后查看”。同意状态会保存在本机；当前开发版本的“不同意并退出”会重新显示欢迎弹窗。Tap Agree and continue if you accept. The next prompt offers View user guide or View later. The app stores acceptance locally; Decline and exit in the current development version presents the welcome alert again.
3. 默认进入“历史”。底部左侧“历史”、中央圆形“扫码”、右侧“设置”；右上连接状态图标负责 Wi-Fi 连接，未连接时显示链环加号图标。首次无历史记录是正常状态。The app opens History. The bottom bar has History on the left, the round Scan control in the center and Settings on the right. The top-right connection status icon controls Wi-Fi and shows a link with a plus badge when disconnected. An empty history on first use is normal.

协议页也能从“设置 → 用户协议 / 隐私政策”再次打开。iOS 版当前仅支持 Wi-Fi 连接电脑，蓝牙键盘输出请使用其他支持 HID 的手机平台。Reopen the documents from Settings → User Agreement / Privacy Policy. iOS currently connects to a computer only over Wi-Fi; use a supported phone platform for Bluetooth keyboard output.

按使用场景授权相机与本地网络Grant camera and local-network access when needed

1. 点“扫码”。尚未连接电脑时会看到“尚未连接 PC 端”，选“继续扫码”保存本机记录，或“立即连接”进入 Wi-Fi 设置；“不再提示”可关闭以后这类提醒。Tap Scan. When disconnected, the Not connected to PC reminder offers Continue scanning for local records or Connect now for Wi-Fi setup. Don’t remind me again suppresses this reminder.
2. 首次使用相机时允许系统相机权限。拒绝后扫码页提示“需要相机权限以进行扫码”，点“授权相机权限”打开系统设置并允许，再回 App。Allow the system camera prompt when first using the camera. After denial, the scanner displays Camera access is required; Grant camera access opens system Settings. Enable access and return.
3. 相册识别使用系统照片选取器，只选择一张图片，无需授权全部图库。取消选图后回到扫码页，不会新增记录。Gallery recognition uses the system photo picker for one image and does not require full-library access. Canceling selection returns to scanning without a new record.
4. 首次连接局域网电脑时允许“本地网络”。曾拒绝时，到系统“设置 → App → 手机扫码枪”（部分系统版本入口不同）重新允许本地网络；相机也在对应 App 设置中管理。Allow Local Network when first connecting to a computer on the LAN. If denied, enable it in system Settings → Apps → Scan Input (the route varies by iOS version). Camera permission is managed in the same app settings.

完成首次使用检查Check that first use is complete

1. 到“设置 → 扫码后缀”选择“无”“回车”或“Tab”，默认回车。后缀仅用于发送，手机历史保留原始内容。Choose None, Enter or Tab in Settings → Scan suffix; Enter is the default. The suffix affects transmitted text only, while History keeps the raw content.
2. 用相机或相册识别一个已知码，到历史核对内容、格式与时间，并试一次复制。未连接电脑也可以完成这一步。Recognize a known code by camera or gallery, verify its content, format and time in History, then copy it. A computer connection is not required.
3. 需要输入电脑时，按 iOS Wi-Fi 专题启动桌面端、连接并测试目标输入框。再按 扫码与导出专题完成系统保存。For computer typing, follow the iOS Wi-Fi topic to run the desktop service, connect and test a target field. Complete file saving with the scanning and export topic.

先选一条使用路线Choose your workflow

这份教程对应手机扫码枪鸿蒙版，覆盖从安装到保存导出文件的完整流程。第一次使用按“安装 → 设置 → 连接 → 扫码 → 历史与导出”操作；只在手机识别并保存内容，可以跳过连接电脑。This guide covers Scan Input for HarmonyOS, from installation to saving an exported file. For a first session, follow installation → settings → connection → scanning → history and export. Skip the computer connection if you only need local recognition and records.

下载、首次启动与权限Install, launch and grant permissions

认识主界面Find the main controls

• “历史”：最新记录在前，每条显示内容、格式与时间，右侧可复制或删除。History lists newest records first, with content, format and time plus copy and delete controls.
• 底部中央圆形按钮：进入全屏扫码页；该页也提供“相册识别”。The center round button opens the full-screen scanner, which also offers Scan from gallery.
• “设置”：后缀、自动恢复连接、震动、声音、网页跳转，以及协议、官网和电脑端下载。Settings provides suffix, connection restore, vibration, sound, webpage opening, legal documents, website and desktop download.
• 右上角链环：断开时用于选择连接方式；连接后点击可查看“当前连接”并“断开当前连接”。连接中请等待结果。The top-right link selects a connection while disconnected. Once connected, tap it to inspect Current connection or Disconnect current connection. Wait for the result while connecting.