Nibo 项目常见问题解决方案

Nibo 项目常见问题解决方案

Nibo Android Place picker dependent on Google places, made a custom version so I could style it anyway I wanted for my current project, WIP 项目地址: https://gitcode.com/gh_mirrors/ni/Nibo

项目基础介绍

Nibo 是一个基于 Android 平台的开源项目，主要用于提供一个可定制的地点选择器（Place Picker），依赖于 Google Places API。该项目允许开发者轻松地将 Google Places 自动完成搜索视图（Autocomplete Search View）集成到他们的应用中，并支持自定义样式和地图标记。Nibo 还提供了起点和终点选择器（Origin and Destination Picker），类似于 Uber 的功能，允许用户选择起点和终点，并获取路线、距离和时间信息。

该项目的主要编程语言是 Java 和 Kotlin，依赖于 Google Play Services 和 RxJava。

新手使用项目时的注意事项及解决方案

1. 依赖库的正确配置

问题描述：
新手在使用 Nibo 项目时，可能会遇到依赖库配置错误的问题，导致项目无法正常编译或运行。

解决步骤：

1. 检查 Google Play Services 版本：
   确保在项目的 build.gradle 文件中正确配置了 Google Play Services 的版本。Nibo 项目要求使用 Google Play Services 11.6.0 或更高版本。

   dependencies {
       implementation 'com.google.android.gms:play-services-places:11.6.0'
   }
   

2. 添加 RxJava 依赖：
   Nibo 项目依赖于 RxJava 2.0 或更高版本。确保在 build.gradle 文件中添加以下依赖：

   dependencies {
       implementation 'io.reactivex.rxjava2:rxjava:2.0.0'
       implementation 'io.reactivex.rxjava2:rxandroid:2.0.0'
   }
   

3. 同步项目：
   在添加完依赖后，点击 "Sync Now" 按钮，确保所有依赖库正确下载并同步到项目中。

2. 权限配置问题

问题描述：
新手可能会忘记在 AndroidManifest.xml 文件中配置必要的权限，导致应用无法访问 Google Places API。

解决步骤：

1. 添加网络权限：
   在 AndroidManifest.xml 文件中添加以下权限，以确保应用可以访问网络：

   <uses-permission android:name="android.permission.INTERNET" />
   

2. 配置 Google Places API 密钥：
   在 AndroidManifest.xml 文件中添加 Google Places API 密钥：

   <meta-data
       android:name="com.google.android.geo.API_KEY"
       android:value="YOUR_API_KEY" />
   

   确保将 YOUR_API_KEY 替换为你在 Google Cloud Platform 上申请的 API 密钥。

3. 检查 API 密钥的限制：
   确保你的 API 密钥没有被限制，或者限制条件与应用的签名证书匹配。

3. 自定义样式和地图标记问题

问题描述：
新手在使用 Nibo 项目时，可能会遇到自定义样式和地图标记不生效的问题。

解决步骤：

1. 检查布局文件中的自定义属性：
   确保在布局文件中正确配置了自定义属性。例如，以下是一个典型的 NiboPlacesAutoCompleteSearchView 的配置：

   <com.alium.nibo.autocompletesearchbar.NiboPlacesAutoCompleteSearchView
       android:id="@+id/autocompletesearchbar"
       android:layout_width="match_parent"
       android:layout_height="wrap_content"
       android:elevation="4dp"
       app:niboSV_customToolbarHeight="?attr/actionBarSize"
       app:niboSV_displayMode="screen_toolbar"
       app:niboSV_editHintText="Search"
       app:niboSV_editHintTextColor="#757575"
       app:niboSV_editTextColor="#757575"
       app:niboSV_homeButtonMode="nibo_burger"
       app:niboSV_searchCardElevation="2dp"
       app:niboSV_searchTextColor="#757575" />
   

2. 实现 NiboAutocompleteSVProvider 接口：
   在 Activity 或 Fragment 中实现 NiboAutocompleteSVProvider 接口，并返回一个有效的 GoogleAPIClient 对象和 NiboPlacesAutoCompleteSearchView.SearchListener 实例。

   public class MyActivity extends AppCompatActivity implements NiboAutocompleteSVProvider {
       @Override
       public GoogleApiClient getGoogleApiClient() {
           return mGoogleApiClient;
       }
   
       @Override
       public NiboPlacesAutoCompleteSearchView.SearchListener getSearchListener() {
           return mSearchListener;
       }
   }
   

3. 设置自定义地图标记：
   如果需要自定义地图标记，可以在 NiboOriginDestinationPickerUI 中设置自定义标记。例如：

   NiboOriginDestinationPickerUI pickerUI = new NiboOriginDestinationPickerUI(this);
   pickerUI.setOriginMarker(R.drawable.custom_marker);
   pickerUI.setDestinationMarker(R.drawable.custom_marker);
   

通过以上步骤，新手可以更好地理解和使用 Nibo 项目，避免常见的配置和使用问题。

Nibo Android Place picker dependent on Google places, made a custom version so I could style it anyway I wanted for my current project, WIP 项目地址: https://gitcode.com/gh_mirrors/ni/Nibo