React Native V2EX

Build Status license GitHub repo size Release Date GitHub last commit tag

项目使用了 React Native 构建了一个 V2EX 移动客户端应用。目的是为了构建一个 React Native 快速开发脚手架。客户端数据完全基于 V2EX 开放 API。基于 RN 0.71.5。

Figma 设计稿 已经开源，可从此 Duplicate。

Installation

TODO

Done

Features

  1. 基于 React Native 0.71.3 版本。
  2. 引入 TypeScript 强类型检查，保证维护性、可读性、稳定性。
  3. eslint 代码规范检查，prettier 代码美化、Husky 作为 git hooks 进行代码格式化、规范校验。
  4. i18n 集成，支持多国语言。实现了语言切换功能。
  5. 实现 APP 主题（浅色、深色、自动切换）切换功能。
  6. 使用 Redux，异步用 Redux Thunk，并用 Redux Persist 数据持久化。
  7. 使用 @redux-devtools/extension 进行 Redux 调试。
  8. 路由使用 React Navgiation，并使用了 Stack Navigator、 Bottom Tabs Navigator、 Material Top Tabs Navigator。
  9. 使用 react-native-splash-screen 控制开屏图。
  10. Toast 同时集成了 react-native-easy-toast、react-native-toast-message。
  11. 日期格式化使用 dayjs。
  12. WebView 使用 react-native-webview。

Preview

iOS

preview

Android

preview

Development

目前在 MacOS 下开发，在 iOS 为 16+ 的 iPhone Simulator/iPhone 14、Android 9.0 的 AVD 模拟器/Mi Phone 均编译成功运行。

具体可根据官网进行 React Native 开发环境和 iOS、Android 运行环境的配置。参考这里。

Develop


# clone repos
$ git clone https://github.com/funnyzak/react-native-v2ex.git && cd react-native-v2ex

# deps install
$ yarn

# 依赖包额外补丁
yarn postinstall

# ios pod install
yarn pod

# start react-native-debugger（only mac）
yarn debug

# debug https://reactnative.cn/docs/debugging
npx react-devtools

# iOS simulator start
yarn ios

# Android simulator start
yarn android

# plop generate template
yarn p

# print rn info
npx react-native info

# upgrade rn version
npx react-native upgrade

# iOS debug info start
npx react-native run-ios --verbose

# iOS release build
npx react-native run-ios --configuration Release

# iOS debug use special device
react-native run-ios --simulator="iPhone 8"

# Android debug info start
npx react-native run-android --verbose

# Testing the release build
npx react-native run-android --variant=release

# build android release apk
cd android
# aab file
./gradlew bundleRelease
# apk file
./gradlew assembleRelease

npx react-native run-android --variant release

Structure

├── src                      # 源码目录
│   ├── App.tsx              # app根组件
│   ├── actions              # actions
│   ├── assets               # 静态资源
│   ├── components           # 组件
│   ├── config               # 配置文件
│   ├── helper               # 应用服务类
│   ├── hooks                # 钩子
│   ├── i18n                 # 多语言支持
│   ├── navigation           # 路由导航
│   ├── reducers             # reducers
│   ├── store                # store
│   ├── theme                # 主题
│   ├── types                # 类型定义
│   ├── utils                # 工具类
│   └── api                  # API库
├── .editorconfig            # 编辑器配置
├── .eslintrc.js             # eslint的配置文件
├── .gitignore               # 配置git提交需要忽略的文件
├── .husky                   # git钩子配置
├── .prettierrc.js           # 代码格式化规则
├── .watchmanconfig          # Watchman的配置文件，用于监控bug文件和文件变化，并且可以出发指定的操作
├── __tests__                # 测试
├── android                  # Android文件所在目录，包含AndroidStudio项目环境文件；
├── app.json                 #
├── babel.config.js          # Babel的配置文件
├── global.d.ts              # ts全局声明文件
├── index.js                 # 程序入口文件
├── ios                      # iOS文件所在目录，包含XCode项目环境；
├── metro.config.js
├── package.json             # 项目基本信息（比如名称、版本、许可证等元数据）以及依赖信息（npm install安装的模块）等
├── tsconfig.json            # typescript编译配置文件
└── yarn.lock                # 依赖版本锁定文件

Contribution

如果你有任何的想法或者意见，欢迎提 Issue 或者 PR。

Debug

Debug Tools

Debug Menu

可以通过摇晃设备或是选择 iOS 模拟器的”Hardware”菜单中的”Shake Gesture”选项来打开开发菜单。另外，如果是在 iOS 模拟器中运行，还可以按下 Command⌘ + D 快捷键，Android 模拟器对应的则是 Command⌘ + M（windows 上可能是 F1 或者 F2），或是直接在命令行中运行 adb shell input keyevent 82 来发送菜单键命令。

react-native-debugger

  1. 安装 react-native-debugger;
  2. yarn debug 启动 react-native-debugger;
  3. 启动模拟器 yarn ios，在模拟器打开 debug remote 选项。

注意： 使用此方式，需要禁用 Hermes，否则会报错。建议启用 Hermes 开关，使用 Hermes 调试。

FAQ

配置 BugSnag

  1. Create a bugsnag account.

  2. Add your project api key to android/app/src/main/AndroidManifest.xml:

       <meta-data android:name="com.bugsnag.android.API_KEY"
              android:value="YOUR-API-KEY-HERE" />

    and ios/app/Info.plist:

     <key>BugsnagAPIKey</key>
 <string>YOUR-API-KEY-HERE</string>

    The API key can be found in the Bugsnag settings for your project.

Invariant Violation: Module AppRegistry is not a registered callable module

npm cache clean --force
watchman watch-del-all
rm -rf node_modules

# for ios
cd ios
pod update && pod install
cd ..
npx react-native run-ios
# for android
cd android && ./gradlew clean
cd ..
npx react-native run-android

Reference: https://stackoverflow.com/questions/64768328/invariant-violation-module-appregistry-is-not-a-registered-callable-module-cal

RCTBridge required dispatch_sync to load RNGestureHandlerModule

https://github.com/software-mansion/react-native-gesture-handler/issues/722

xcode 编译报错

# 删除编译缓存
rm -rf ~/Library/Developer/Xcode/DerivedData

Android 编译启动注意

注意 gradle 和 java sdk(java home)的版本对应，可在 ./android/gradle.properties 设置 org.gradle.java.home

开屏图的设置

iOS 使用 LaunchScreen.storyboard，使用 Xcode 修改即可。

修改 bundle name

看这里。

Android 签名打包发布

看这里。

Using fetch to get/post on a HTTPS web server which is using a valid and trusted but not public CA.

  1. Edit the android/app/src/main/AndroidManifest.xml
  2. Add the android:networkSecurityConfig=”@xml/network_security_config” to the tag
  3. Create the folder android/app/src/main/res/xml and inside a file called network_security_config.xml 
    <?xml version="1.0" encoding="utf-8"?>
<network-security-config>
  <base-config cleartextTrafficPermitted="true" />
</network-security-config>

Dependencies

Reference

License

Apache-2.0 License © 2021 funnyzak