BasePopup: A Java repository from cheunjq

BasePopup - Android下打造通用便捷的PopupWindow

Release	Candy	License	Api	Author

Compat组件		support（已终止迭代）	lifecycle（已终止迭代）	androidx
	Release
	Candy

特性

更简单更精准的控制显示位置，通过Gravity和offset来控制您的PopupWindow
本库为抽象类，对子类几乎没有约束，您完全可以像定制Activity一样来定制您的PopupWindow
支持Animation、Animator，随意控制您的PopupWindow的动画，再也不用去写蛋疼的xml了
顺滑的背景定制，支持背景模糊或局部模糊，展开变暗或者修改颜色甚至是贴图，这一切仅仅需要您通过一句Api完成
不再担心PopupWindow蛋疼的事件拦截，返回键控制、点击外部Dismiss控制、外部事件响应控制三者分离
PopupWindow自动锚定AnchorView，滑动到屏幕外自动跟随AnchorView消失，不需要复杂的逻辑设置，只需要通过Link方法告诉BasePopup
简单的PopupWindow不想新建一个类，希望拥有链式调用？没问题，QuickPopupBuilder为此而生，相信你会越用越爱~

注意事项

请务必仔细阅读本README,每个版本升级请务必查阅更新日志，这可以为您减少不必要弯路
请注意引用版本的问题，Release版本是稳定版，Candy是预览版。
- Release版本：一般在Candy版本反复验证修复后发布到Release，如果您对稳定性要求较高，请使用Release版本。
- Candy版本：一般新功能、issue修复都会发布到Candy版本，Candy版本发布比较频繁，但通常会拥有新的功能，如果您喜欢试验新功能同时对稳定性要求不高，请使用Candy版本。
- Release和Candy两个版本互相切换可能会导致Build失败，这时候您Clean一下Project即可
如果您是以前1.x版本的用户，现在想更新到2.x，请在更新前查阅：1.x迁移到2.x帮助文档
从16年第一次提交到现在，本人技术也一直在进步，BasePopup也会一直迭代更新，所以，请谨慎选择版本哦~一不小心就颠覆了之前的实现。

环境依赖

请把下述 {$latestVersion} 替换为上面表格中对应的版本。

自2.2.2版本开始，BasePopup将不再支持support，同时BasePopup建议您尽早迁移到AndroidX

Release：
- 基础库（必选）：implementation 'com.github.razerdp:BasePopup:{$latestVersion}'
- support支持库（可选）：implementation 'com.github.razerdp:BasePopup-compat-support:{$latestVersion}'
- lifecycle支持库（可选）：implementation 'com.github.razerdp:BasePopup-compat-lifecycle:{$latestVersion}'
- androidx支持库（可选，不可跟别的支持库同时存在）：implementation 'com.github.razerdp:BasePopup-compat-androidx:{$latestVersion}'
Candy
- 基础库（必选）：implementation 'com.github.razerdp:BasePopup_Candy:{$latestVersion}'
- support支持库（可选）：implementation 'com.github.razerdp:BasePopup_Candy-compat-support:{$latestVersion}'
- lifecycle支持库（可选）：implementation 'com.github.razerdp:BasePopup_Candy-compat-lifecycle:{$latestVersion}'
- androidx支持库（可选，不可跟别的支持库同时存在）：implementation 'com.github.razerdp:BasePopup_Candy-compat-androidx:{$latestVersion}'

快速入门

请参考文档：BasePopup手册

Api（请看Wiki，后续迁移至文档）

Link👉WIKI

更新日志 (历史更新)

近期正在重构BasePopup，旨在代码更容易读，因此近期更新可能较慢，新版本将会对issue统一处理
【Candy】2.2.2
- 【Candy】190704
  - 修复AnimatorSet的时间问题 fix #203
- 【Candy】190722
  - 回滚#188修复
  - 经检查，#188修复带来的问题比较严重，建议升级到该版本
- 【Candy】190816
  - 考虑到很多用户提出全面屏会有蒙层无法填充的问题，因此增加setMaskLayoutWidth和setMaskLayoutHeight方法，该方法允许您自定义蒙层的高度
  - 开始重构BasePopupWindow，本次重构将会解决遗留问题同时缩减冗余代码，并提高代码可读性
- 【Candy】190904
  - 重构屏幕宽高获取逻辑
  - 修改supporter名字为component
- 【Candy】190912
  - 重构键盘逻辑，现在键盘对齐支持选择模式了~
  - 相关文档请查阅文档 键盘（输入法）
- 2019/09/20
  - Demo大翻新
- 2019/09/22
  - 增加输入法Demo
  - Demo支持更新
  - Demo增加issue修复测试用例
- 2019/09/26
  - 取消对support的支持
- 2019/09/27
  - 增加手势导航栏支持
- 2019/09/29
  - 发布新版candy
- 2019/10/09
  - 添加issue #230测试用例
- 2019/10/31
  - 优化autoLocate
  - 优化超出屏幕的位移问题
  - 添加setResize()方法
  - 添加onAutoLocationChange()方法
【Release】2.2.1(2019/06/24)
- 支持Service或者非ActivityContext里弹窗
- 优化PopupUiUtils，优化获取屏幕宽高算法
  - fixed #186、#167
  - fixed #188(not perfect)
- 修改并优化键盘判断逻辑
- 优化全屏状态下点击范围的判定，fixed #200
【Release】2.2.0(2019/05/15)
- 正式版2.2.0隆重归来，这次正式版又是一个重构版本哦~
- 优化输入法对齐逻辑
- 重构模糊逻辑：
  - 经测试，720p的手机在默认参数下全屏模糊时间平均在6ms~16ms之间
  - 增大默认参数的模糊程度
  - 模糊淡入淡出时间跟随Popup的动画时间
  - 修复模糊偶尔失效的情况
- 测量/布局相关：
  - 重构测量逻辑：
    - 现在在clipToScreen的情况下，会根据剩余空间对PopupDecor进行重新测量，以保证Popup完整的显示，如果您需要保持原始的测量值，请调用keepSize(true)
    - 重构layout逻辑，针对outSideTouch优化
    - 适配屏幕旋转，fix #180
    - 采取flag代替各种boolean，清爽更简洁
    - 减少冗余代码
- 优化相关：
  - 增加GravityMode值，现在允许您配置PopupGravity的参考模式啦~
    - RELATIVE_TO_ANCHOR：默认模式，以Anchor为参考点，指定PopupWindow显示在Anchor的方位
    - ALIGN_TO_ANCHOR_SIDE：对齐模式，以Anchor的边为参考点，指定PopupWindow的边与Anchor的哪条边对齐
  - 增加minWidth/minHeight 方法，增加maxWidth/maxHeight 方法，让他们相互对应~
  - 修复高度为match_parent和wrap_content的测量差异，现在可以安心地玩耍啦
  - 部分Api标记过时：
    - ~~setAllowDismissWhenTouchOutside~~ -> setOutSideDismiss
    - ~~setAllowInterceptTouchEvent~~ -> setOutSideTouchable
  - 增加setBackgroundView(View)方法，现在BasePopup的背景控件可以随意由你定制啦~当然PopupWindow的背景动画控制方法依旧生效
- 包拆分：
  - 现在BasePopup将会进行包的拆分，源工程仅针对没有任何依赖的原生Android进行适配，如果您需要别的适配，请分别依赖以下模块或多个模块：
    - 如果您需要support库的支持，比如DialogFragment支持，请依赖
      - implementation 'com.github.razerdp:BasePopup-compat-support:{$latestVersion}'
    - 如果您需要lifecycle库的支持，比如destroy里自动释放或者关闭等，请依赖
      - implementation 'com.github.razerdp:BasePopup-compat-lifecycle:{$latestVersion}'
    - 如果您需要androidX库的支持，请依赖
      - implementation 'com.github.razerdp:BasePopup-compat-androidx:{$latestVersion}'
    - 请注意，如果您依赖了androidX支持组件，请不要依赖另外两个支持组件，否则会冲突
- Bug fixed：
  - fix #171、#181、#182、#183
  - fix #180
  - fixed #164
- Other：
  - add 996 license