简介
在移动应用开发中，为了提供更好的用户体验，我们通常会引入一些工具包来加强应用的功能性。其中，Helpshift 可以作为一个简单而又有效的客服解决方案，用于帮助我们处理用户反馈和问题。而对于 React Native 开发者来说，使用 Helpshift 更加便捷，只需要安装 Helpshift 的 npm 包即可。
安装
在项目根目录下使用以下命令安装：
npm install react-native-helpshift --save
配置
iOS
添加依赖
打开
Xcode，在Build Phases -> Link Binary with Libraries中添加以下依赖库：libHelpshift.a（Helpshift 库）MessageUI.framework（处理邮件消息）SystemConfiguration.framework（系统配置）
在
Build Settings -> Search Paths -> Header Search Paths中添加 Helpshift 的头文件路径，如果使用cocoapods则为：
$(CHAT_SDK_PATH)/Helpshift-iOS-SDK/Helpshift.framework/Headers
- 在
Build Settings -> Linking -> Other Linker Flags中加入-ObjC。
配置信息
- 在 Xcode 中打开
Info.plist文件，并添加以下配置：
-- -------------------- ---- ------- ------------------- ----------------------------- ---------------------- -------------------------------- --------------------- ------------------------------ ------------------------------------ -------------------- ---------------------------------- ------------ -- ---- -- ---------------------- --------------------------------------- ------------- -- --- -- --- ------ ----------------- ------------------------- -------------------- ---- ------------ - --------- --- --- --- --- ---- --------------- - --------- --- ------ --- --- ---- ------------- - --------- -------- --- - ------- ---
- 如果需要 push 通知功能，还需要在
Capabilities中打开Push Notification。
Android
配置信息
- 在
AndroidManifest.xml文件中添加以下权限：
<uses-permission android:name="android.permission.INTERNET" /> <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" /> <uses-permission android:name="android.permission.SYSTEM_ALERT_WINDOW" /> // 仅在 Android 6.0 及以上版本需要
- 在
android文件夹下的build.gradle文件中添加以下依赖：
dependencies {
implementation 'com.helpshift:android-core:6.7.0'
implementation 'com.helpshift:android-api:6.7.0'
}- 在
res文件夹下创建xml文件夹，并在xml文件夹中创建一个helpshift.xml文件，添加以下内容：
<?xml version="1.0" encoding="UTF-8"?>
<resources>
<string name="helpshift_api_key">YOUR_API_KEY</string>
<string name="helpshift_domain">YOUR_DOMAIN</string>
<string name="helpshift_enable_contact_us">YOUR_ENABLE_CONTACT_US_FLAG</string>
<string name="helpshift_theme">YOUR_THEME_IDENTIFIER</string>
</resources>其中，
YOUR_API_KEY是 Helpshift 提供的 API key；YOUR_DOMAIN是 Helpshift 配置的平台名字；YOUR_ENABLE_CONTACT_US_FLAG为TRUE表示启用联系我们按钮，为FALSE则表示禁用；YOUR_THEME_IDENTIFIER是 Helpshift 自定义 Theme 的标识符。
- 在
AndroidManifest.xml文件中，添加以下配置信息：
<meta-data android:name="helpshift_api_key" android:value="@string/helpshift_api_key"/> <meta-data android:name="helpshift_domain" android:value="@string/helpshift_domain"/> <meta-data android:name="helpshift_enable_contact_us" android:value="@string/helpshift_enable_contact_us"/> <meta-data android:name="helpshift_theme" android:value="@string/helpshift_theme"/>
使用
在项目中使用时，需要先引入 react-native-helpshift 并初始化：
-- -------------------- ---- -------
------ --------- ---- -------------------------
----- -------- --------------- -
--- -
----- ------ - -
------- ---------------
----------- -------------------
------- ---------------
----------- -------------------
------------------------ -----
--------------- -----
--
----- -----------------------------
- ----- ------- -
---------------------
-
-
----------------在初始化完成之后，即可使用 Helpshift 的各种 API 函数，例如：
-- -------------------- ---- -------
----- -------- ---------- -
--- -
----- ---------------------
- ----- ------- -
---------------------
-
-
----- -------- ------------------ -
--- -
----- -----------------------------
- ----- ------- -
---------------------
-
-
----- -------- ------------------------- -
--- -
----- ------------------------------------
- ----- ------- -
---------------------
-
-
----- -------- -------------------- -
--- -
----- -------------------------------
- ----- ------- -
---------------------
-
-
----- -------- --------------------------------- -
--- -
----- --------------------------------------------
- ----- ------- -
---------------------
-
-
----- -------- --------------------- ------ -
--- -
----- ------------------------------- -------
- ----- ------- -
---------------------
-
-总结
通过本教程的学习，我们了解到了如何在 React Native 应用中使用 Helpshift，使得我们的应用能够更加完善和强大。通过 Helpshift 提供的各种 API，我们能够实现丰富的用户反馈和问题回答功能，提升移动应用的用户体验和用户满意度。希望本教程对你有所帮助。
来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/600562bc81e8991b448dffdf