pslab android下载 - pslab android源代码下载

pslab android

JAVA源码

PSLab Version 3.1.36

下载

PSLab Android 应用程序

PSLab Android 应用程序的存储库，用于使用 Pocket Science Lab 开放硬件平台执行实验。

该存储库包含用于使用 PSLab 执行实验的 Android 应用程序。 PSLab 是一个小型袖珍科学实验室，提供一系列用于进行科学和工程实验的设备。它的功能类似于示波器、波形发生器、频率计数器、可编程电压和电流源以及数据记录器。我们的网站是 https://pslab.io。

在这里加入我们的测试计划，注册最新更新并尽早测试新功能。

在 Google Play 上获取在 F-Droid 上获取

买

您可以从 FOSSASIA 商店购买 Pocket Science Lab 设备。
PSLab 网站上列出了更多经销商。

沟通

PSLab 聊天频道位于 Gitter 上。
也请加入我们的 PSLab 邮件列表。

路线图

首先我们需要让 Android 应用程序和 PSLab 之间的通信正常工作。
实施应用程序并向用户公开 PSLab 硬件功能。
实施无线连接

截图

视频演示

PSLab Android 应用程序概述。
使用 PSLab 设备观察声音波形。
使用 Pocket Science Lab 进行实时传感器数据记录。
使用 Pocket Science Lab 生成和观察波形。

特征

特征	描述	地位
主屏幕	显示 PSLab 设备的状态和版本	✔️
仪器仪表	暴露 PSLab 仪器，如示波器等	✔️
示波器	显示模拟信号的变化	✔️
万用表	测量电压、电流、电阻和电容	✔️
逻辑分析仪	捕获并显示来自数字系统的信号	✔️
波浪发生器	生成任意模拟和数字波形	✔️
电源	生成可编程电压和电流	✔️
照度计	测量环境光强度	✔️
晴雨表	测量压力	✔️
加速度计	测量设备的加速度	✔️
陀螺仪	测量转速	✔️
罗盘	测量相对于地磁极的绝对旋转	✔️
温度计	测量环境温度	✔️
气体传感器	检测气体，包括 NH3、NOx、酒精、苯、烟雾和 CO2	✔️
机械臂控制器	可独立控制机械臂的4个伺服电机	✔️

如何在您的开发环境中设置 Android 应用程序

应用口味

PSLab Android 应用程序有 2 种风格（构建变体）。

Play 商店风味

Play 商店风格使用 Google 地图来显示数据记录器中日志中存储的位置。

Fdroid 口味

Fdroid 风格使用开放街道地图来显示存储在数据记录器日志中的位置。

开发设置

在开始之前，您应该已经下载并正确设置了 Android Studio SDK。您可以在此处找到有关如何执行此操作的指南：设置 Android Studio

设置 Android 项目

要设置 PSLab Android 项目，您可以遵循下面列出的两种方法中的任何一种，即，您可以下载存储库 zip 文件，也可以直接将存储库克隆到 Android Studio。

通过下载 zip 文件

下载pslab-android项目源代码。您可以通过分叉和克隆存储库（如果您计划推送更改，建议使用）或将其下载为 ZIP 文件并解压来完成此操作。
打开 Android Studio，您将看到欢迎使用 Android窗口。在快速启动下，选择_导入项目（Eclipse ADT、Gradle 等）。要通过 Wi-Fi 进行调试，请按照本博客中给出的步骤操作。

注意：如果您构建自己的硬件，请更改 CommunicationHandler.java 中的 VendorID 和/或 ProductID。

通过直接克隆

打开 Android Studio，您将看到欢迎使用 Android窗口。在“快速启动”下，选择“从版本控制中签出项目”。
从出现的下拉菜单中选择 git。
转到存储库并单击克隆或下载按钮。
从出现的下拉列表中复制链接。
粘贴您复制的 URL，然后按克隆。
Android studio 现在应该开始使用 gradle 构建项目。
此过程完成并打开 Android Studio 后，检查控制台是否有任何构建错误。

注意：如果您收到标题为“无法找到...”的 Gradle 同步错误，您应该单击错误消息下方的链接（如果有），其中显示安装缺少的平台和同步项目并允许 Android studio给你找来缺少的东西。

解决所有构建错误后，您应该准备好构建应用程序并测试它。
要构建应用程序，请转到“构建”>“创建项目” （或者按工具栏中的“创建项目”图标）。
如果应用程序构建成功，您可以通过在真实设备或模拟设备上运行它来测试它，方法是转到“运行”>“运行‘应用程序’”或按工具栏中的“运行”图标。

如果您只想构建 apk，请转到“构建”>“构建 apk”，将构建 apk，并且 Android Studio 会提示生成 apk 的目录。

由于 PSLab 设备通过 OTG 线连接到 micro-USB 端口，因此无法按常规方式进行调试。因此 Android 设备未通过 USB 线连接到 PC。

要通过 Wi-Fi 进行调试，请按照本博客中给出的步骤操作。

注意：如果您构建自己的硬件，请更改 CommunicationHandler.java 中的 VendorID 和/或 ProductID。

所需权限

Record_Audio：示波器需要接受来自手机内置麦克风的输入。您可以在 AudioJack.java 中找到它的实现。
Access_Fine_Location 和 Internet ：需要在照度计和指南针中使用才能获取在地图上标记数据的坐标。您可以在 GPSLogger.java 中找到它的实现。
Write_External_Storage ：需要存储来自仪器的日志文件，以便将来进行分析。
Read_External_Storage ：在存储中写入日志时，CSVLogger.java 首先检查是否存在任何需要此读取权限的 CSVLogger 目录。

设置通过 Android 应用程序使用 PSLab

要将 PSLab 设备与 Android 一起使用，您只需一根 OTG 电缆、启用了 USB 主机功能的 Android 设备（大多数现代手机都支持 OTG）和 PSLab Android 应用程序。通过 OTG 线将 PSLab 设备连接到 Android 手机。休息由App自己处理。

贡献最佳实践

代码实践

请帮助我们遵循最佳实践，以便审阅者和贡献者都能轻松完成。我们希望更多地关注代码质量，而不是管理拉取请求道德。

每个拉取请求一次提交。
参考提交消息中的问题编号。遵循模式Fixes #<issue number> <commit message>
遵循统一的设计实践。整个应用程序的设计语言必须保持一致。
除非提交被压缩，否则拉取请求不会被合并。如果 PR 上有多个提交，提交作者需要压缩它们，而不是维护者挑选和合并压缩。
如果 PR 与任何前端更改相关，请在拉取请求描述中附上相关屏幕截图。

如何`git squash` ？

对于那些努力将提交压缩为一个的新开发人员来说，这是一个提示，您的拉取请求中可能会出现多个提交，主要是由于以下原因。

每次更改后有意添加多个提交消息，而不仅仅是git add 。
使用远程更新当前分支，以便进行合并提交。

无论出于何种原因，请按照下面给出的步骤将所有提交压缩为一个符合我们最佳实践的提交。

如果之前未设置，则设置远程到上游分支

$ git remote add upstream https://github.com/fossasia/pslab-android.git

检查与拉取请求相关的分支

$ git checkout <branch-name>

执行软重置以保留更改，同时删除所有提交详细信息

$ git reset --soft upstream/development

将文件添加到暂存区

$ git add <file paths or "." to add everything>

遵循提交消息指南，使用正确的消息创建新提交

$ git commit -m "tag: commit message"

如果您已经提出了拉取请求

$ git push -f origin <branch-name>

分行政策

我们有以下分行

开发所有开发都在这个分支中进行。如果您正在做出贡献，您应该向development提出拉取请求。确保它通过 Travis 的构建检查。
master这包含稳定的代码。在开发中积累了重要的功能/错误修复后，我们将其移至掌握。
apk该分支包含自动生成的用于测试的 apk 文件。

代码风格

请在编写和提交代码时尝试遵循上述指南，因为这样可以让审阅者和其他开发人员更容易理解。

在命名布局文件时，请确保遵循的约定是 (activity/fragment) _ (name).xml ，例如activity_oscilloscope.xml 、 fragment_control_main.xml 。
将布局文件中定义的视图和小部件命名为 (viewtype/widget) _ (fragment/activity name) _ (文件中的编号)，例如spinner_channel_select_la1 、 button_activity_oscilloscope1 。
布局文件对应的activity/fragment文件名应命名为 (activity/fragment name)(activity/fragment).java ，就像布局文件fragment_channels_parameter.xml对应的ChannelsParameterFragment.java一样。
活动文件中按钮、文本框、复选框等对应的小部件应命名为 (viewtype/widget)(fragment/activity name)(文件中的编号)，如spinnerChannelSelect1对应spinner_channel_select1 。