kivy / kivy/python-for-android

Enhancement request: add documentation that your venv must not be in the project folder

Đang mở
#2,848 1 bình luận 0 reaction 0 người được giao Xem trên GitHub
feature-request
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

Mở 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

Nhận issue mới trong hộp thư của bạn

Bản tóm tắt ngắn những issue GitHub phù hợp với người mới.