Title: Kivy-Desinger on Mac ImportError: No module named filebrowser
Date: 2016-12-31
Category: Kivy
Tags: Python,Mac,Kivy

解决Mac系统上Kivy-Desinger因Garden安装位置不匹配导致的filebrowser无法导入的问题

根据官方文档，首先要

  1. kivy -m pip install -U watchdog pygments docutils jedi gitpython six kivy-garden

然后

  1. garden install filebrowser

然后你以为一切都很好，尝试运行Kivy-Designer，你会遇到类似下面的错误提示：

  1. [WARNING           ] stderr:     from designer.app import DesignerApp
  2. [WARNING           ] stderr:   File "/Users/cycleuser/kivy-designer/designer/app.py", line 27, in <module>
  3. [WARNING           ] stderr:     from kivy.garden.filebrowser import FileBrowser
  4. [WARNING           ] stderr: ImportError: No module named filebrowser

这是因为，garden在Mac OS X下安装的位置是Linux下的 ~/.kivy/garden 目录下，而在Mac OS X下这个位置是无效的，必须要手动复制到 /Applications/Kivy.app/Contents/Resources/.kivy/garden 目录下。

读到这里你应该就能解决问题了，仔细阅读官方文档，虽然在garden安装位置这个bug上并没什么用。

下面的内容是我在去年时候无脑尝试的记录，仅仅作为教训有参考意义而已，不要像我一样蠢。
分割线下面的内容就不用看了，没什么意义~

At first, I ran the commands below to install Kivy on my Mac:

最开始是安装依赖包，我用的是 brew，官方这么推荐就这么用了哈：

  1. brew install sdl2 sdl2_image sdl2_ttf sdl2_mixer gstreamer
  2. pip install -I Cython==0.21.2
  3. USE_OSX_FRAMEWORKS=0 pip install git+https://github.com/kivy/kivy.git@1.9.0

After that, I download the Kivy dmg from the official website.

然后呢，就去官网下载最新的那个 kivy 的 dmg，这个是用来在 Mac 上面建立一个 Kivy 官方给打包好的 Python 虚拟环境，就不用自己折腾了。最下面哪句点击 MakeSymlinks 就是用来建立系统映射的一个脚本，到时候在终端直接输入 kivy 就是运行的 kivy.app 内部的一个 Python2.7了，而不用自己折腾配置了。你看这一句英文我翻译解释出这么多，是因为我觉得身边的小白蛮多，解释清楚点比较好。
（虽然英文版的也是我写的，但我懒得写的那么细，网上英语资料很多，就让他们自己搜去吧。。。）

  1. Download the latest version from http://kivy.org/#download
  2. Double-click to open it
  3. Drag the Kivy.app into your Applications folder
  4. Double click the makesymlinks script.

Then I used git to download the kivy-designer.
I thought it would work.
So I typed in the command below following the official guide with hope:

接着就用 git 下载来 kivy-designer。
满心开心希望能用了。
所以就根据官方指南输入下面的命令，满眼星星的期待呢：

  1. kivy main.py

But I got this error:

尼玛给老子来了个错误：

  1. [WARNING           ] stderr: ImportError: No module named filebrowser

Details here:

细节是这样的：

  1. [INFO              ] Logger: Record log in /Applications/Kivy.app/Contents/Resources/.kivy/logs/kivy_15-12-29_18.txt
  2. [INFO              ] Kivy: v1.9.0
  3. [INFO              ] Python: v2.7.10 (default, Jul 14 2015, 19:46:27) 
  4. [GCC 4.2.1 Compatible Apple LLVM 6.0 (clang-600.0.39)]
  5. [INFO              ] Image: Providers: img_tex, img_imageio, img_dds, img_gif, img_sdl2 (img_pil, img_ffpyplayer ignored)
  6. [INFO              ] Factory: 173 symbols loaded
  7. [INFO              ] Text: Provider: sdl2
  8. [INFO              ] OSC: using <multiprocessing> for socket
  9. [INFO              ] Window: Provider: sdl2
  10. [INFO              ] GL: OpenGL version <2.1 INTEL-10.6.33>
  11. [INFO              ] GL: OpenGL vendor <Intel Inc.>
  12. [INFO              ] GL: OpenGL renderer <Intel HD Graphics 4000 OpenGL Engine>
  13. [INFO              ] GL: OpenGL parsed version: 2, 1
  14. [INFO              ] GL: Shading version <1.20>
  15. [INFO              ] GL: Texture max size <16384>
  16. [INFO              ] GL: Texture max units <16>
  17. [INFO              ] Window: auto add sdl2 input provider
  18. [INFO              ] Window: virtual keyboard not allowed, single mode, not docked
  19. [WARNING           ] stderr: Traceback (most recent call last):
  20. [WARNING           ] stderr:   File "main.py", line 2, in <module>
  21. [WARNING           ] stderr:     from designer.app import DesignerApp
  22. [WARNING           ] stderr:   File "/Users/cycleuser/kivy-designer/designer/app.py", line 27, in <module>
  23. [WARNING           ] stderr:     from kivy.garden.filebrowser import FileBrowser
  24. [WARNING           ] stderr: ImportError: No module named filebrowser

Yep, I found that the filebrowser was missing.
So I run:

对呗，filebrowser 没安装是吧，那就安装咯。
就运行一下安装工具就是了：

  1. kivy -m pip install -U watchdog pygments docutils jedi gitpython six kivy-garden
  2. garden install filebrowser

If you run：

当然，最开始其实我运行的是：

  1. pip install -U watchdog pygments docutils jedi gitpython six kivy-garden

instead of

而没注意官方告诉的要运行：

  1. kivy -m pip install -U watchdog pygments docutils jedi gitpython six kivy-garden

you may waste a lot of time…
Because you can still run

这样就会浪费好多时间。。。
因为两种方式安装之后，会发现都能运行下面的命令来安装 filebrowser ：

  1. garden install filebrowser

But the location of garden would be in the user path of “~/.kivy/garden” instead of the right location as below:

但安装位置是不一样的！！！如果像我那样安装就跑到用户目录下面安装了，而不是安装在正确位置，下面的位置是正确位置：

  1. /Applications/Kivy.app/Contents/Resources/.kivy

The kivy.app run when you type “ kivy main.py “ from the location below:

当运行 kivy.app 的时候，跑的是 kivy.app 路径里面的 Python，也会在这个里面找 filebrowser，如果安装到用户路径去了，当然就找不到了啊：

  1. /Applications/Kivy.app/Contents/Resources/.kivy

So if you install garden and filebrowser in the home dir, you can copy the garden dir from “ ~/.kivy “ to “ /Applications/Kivy.app/Contents/Resources/.kivy “.

所以如果你跟我一样安装到用户目录了，就把东西从” ~/.kivy “复制到” /Applications/Kivy.app/Contents/Resources/.kivy “就可以了。

Then try to run “kivy main.py” and everything is OK now.

然后再运行”kivy main.py”，就发现可以跑界面设计工具了。

Always remember to add “kivy -m “ before “pip install”!
I hope that this could help other on similar problems.

一定要记住，在”pip install”的前面要添加”kivy -m “，这样才能安装到 Kivy.app 的路径内，而不是系统路径中！
唉，希望能帮助其他遇到类似问题的小伙伴吧。

I hope kivy can give a tip about the location of garden installed so we careless people may save a lot of time.

其实安装 garden 的时候 kivy 如果能给提示一下安装路径该有多好，这样起码容易注意到这个问题了。