kivy / kivy/python-for-android
Enhancement request: add documentation that your venv must not be in the project folder
- Ngôn ngữ chính
- Python
- Star
- 8.9k
- Fork
- 2k
- Merge trung bình
- 12 giờ 20 phút
- Pull request đã merge (30 ngày)
- 9
Mô tả
I had encountered a mysterious issue where my project would appear to build cleanly, but python packages would sometimes go missing while trying to run the app.
Specifically, the app would crash during launch and any number of ModuleNotFoundErrors would appear in the logcat.
E.g. `ModuleNotFoundError: No module named 'paramiko'`
This behavior only appeared when certain packages were added, which made it more confusing. Using just python, kivy, and numpy, for example, caused no problems. (Might be related to things with recipes? Hard to tell)
This happened even when the various suggestions in the [troubleshooting guide](https://github.com/Android-for-Python/Android-for-Python-Users#non-deterministic-behavior) were followed, such as completely wiping the build and starting over, explicitly adding the full dependency tree(s) to the .spec requirements, ensuring nothing would cause non-deterministic behavior, etc.
What finally solved the issue was the realization that having my virtual environment folder **within** the project folder caused some kind of interference with the process (even though it was supposedly being ignored via the `source.exclude_dirs` parameter in the .spec file) .
### Summary
Please add documentation that including your virtual environment folder within your project's folder (where it will be seen by buildozer/p4a) can/will prevent the app from running even if it builds without obvious issues.
Hướng dẫn đóng góp
Hướng nghiên cứu
Bắt đầu với hướng dẫn khắc phục sự cố được liên kết và kiểm tra cấu trúc tài liệu của repository để xác định vị trí phù hợp. Công việc được xem là hoàn tất khi tài liệu cảnh báo rõ ràng rằng một môi trường ảo bên trong thư mục dự án có thể gây ảnh hưởng đến buildozer/python-for-android và giải thích nên lưu giữ nó ở đâu thay vào đó.
Do mô hình lập chỉ mục viết ra từ nội dung của issue.
Đánh giá
- Công nghệ
- android, python
- Lĩnh vực
- documentation
- Loại issue
- Tài liệu
- Độ khó
- 2/5
- Thời gian dự kiến
- 1-3 giờ
- Mức độ hoạt động
- Đình trệ
- Độ rõ ràng
- Khá rõ ràng
- Mức phù hợp với người mới
- 35/100